7 



VECTOR 4 CP/M 


PROGRAMMERS GUIDE 


Version 1.0 


Revision A 
September 1, 1982 


Copyright 1982 by Vector Graphic, Inc. 


P/N 7100-9003 



Copyright 1982 by Vector Graphic, Inc. 

All rights reserved. 

DISCLAIMS 

Vector Graphic makes no representations or warranties with respect to the contents 
of this manual itself, whether or not the product it describes is covered by a 
warranty or repair agreement. Further, Vector Graphic reserves the right to revise 
this publication and to make changes from time to time in the content hereof 
without obligation of Vector Graphic to notify any person of such revision or 
changes, except when an agreement to the contrary exists. 

RE VI SI O N NUMBERS 

The date and revision of each page herein appears at the bottom of each page. 
The revision letter, such as A or B, changes if the manual has been improved but 
the product itself has not been significantly modified. The date and revision on the 
Title Page corresponds to that of the page most recently revised. When the 
product itself is modified significantly, the product will get a new revision number, 
as shown on the manual’s Title Page, and the manual will revert to revision A, as 
if it were treating a brand new product. THE MANUAL SHOULD ONLY BE USED 
WITH THE PRODUCT(S) IDENTIFIED ON THE TITLE PAGE. 


X R AH EM AILS 

CP/M is a registered trademark of Digital Research. 



Audience 

Scope 


Organization 


JEjQJBLEJLQSJO 

The Vector 4 CP/M Programmer’s Guide is designed for System 
Programmers. 

The Vector 4 CP/M Programmer’s Guide covers all aspects of 
the Vector 4 CP/M Operating System. It describes the 
command structure along with the numerous BDOS functions. 
It also lists all the BIOS Jump Routines. 

The Vector 4 CP/M Programmer’s Guide is organized into five 
sections. The first section gives an overview of Vector 4 
CP/M. Sections n and m describe the Resident and Transient 
Commands. The last two sections give the BDOS system calls 
and the BIOS Jump Routines. 
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SECTION I - INTRODUCTION TO VECTOR 4 CP/M 


L I .HA R PWABE..ERQY3SIQNS 

A* Disk-Driy.es 

There are two types of disk drives that are supported by the VECTOR 4 CP/M 
Operating System: the 5 1/4-inch floppy, and the 5 1/4-inch hard disk. 

EL Diskettes 

The Vector 4 uses an industry standard 5 1/4-inch diskette with 16 ’hard 
sectors’. This diskette has 16 sector holes and one additional index hole 
around the edge of the center hole. They are usually marked with the number 
’16’ on the label. You can purchase them from computer stores or from other 
computer supply sources. 

1 .2 G ENERAL .CON VE NTIONS 


The following keyboard and entry conventions are used throughout the VECTOR 
4 CP/M Programmer’s Guide. 

Key Strokes 


Return key = 
Control key = 

Escape key = 
Tab key = 
Spacebar = 
Backspace = 
Delete key = 
Line Feed = 
Shift = 
Options = 


[RETURN] 

[CTRL x] where x = any of the keys used in a control 
sequence; both keys are pressed together simultaneously. 

[ESC] 

[TAB] 

[SPACE] 

[BACKSPACE] 

[DEL] 

[LF] 

[SHIFT] 

<option(s)> where any option(s) are enclosed in < >. 
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Entry 

A command line within VECTOR 4 CP/M consists of several components: 

• Command 

• Drive(s) 

• Filename(s) and extension(s) 

• Option(s), if available 

• [RETURN] to process 

for instance, the command line to copy a file: 

PIP Ar=B:MEMORITE.*[V] [RETURN] 

which means Copy to Drive A ail files from Drive B having a filename of 
MEMO RITE with any extension and verify the transfer of data. [RETURN] 
represents the key which is pressed to process the command. 

Note: All options within PIP, i.e., the ’V’ in the above command line, must 

have brackets around the option; the option to verify, [V] with brackets, must 
be part of the command line in order to verify the transfer of data (see 
Paragraph 3.2.7 for more information on the PIP command). 


U . INSTALLING V ECTOR -l.CgZM 

VECTOR 4 CP/M is shipped on a System diskette, and, in the case of a hard disk 
system, on the hard disk as well as on a diskette. It is extremely important to 
backup the System diskette immediately because it is possible that the hard disk 
could be damaged and the information contained on it destroyed. It would 
therefore be impossible to generate another system on the hard disk if the System 
diskette has been destroyed or damaged, and no backup copy had been made. 

Am. Diskette Copy 

To install or place the VECTOR 4 CP/M operating system onto a blank 
double-sided diskette enabling you to boot, or bring up, the system from that 
diskette, simply copy the VECTOR 4 CP/M System diskette to a ’personalized’ 
diskette by using the DISKCOPY program (see Paragraph 3.2.9). 
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To install the operating system on a diskette already in use, copy the 
operating system by using the GEN SYS program (see Paragraph 3.2.1-A.). 

To install the operating system onto a blank diskette which is to be used for 
data (other than a System diskette), it is necessary to initialize the diskette 
first (a new diskette must first be ’initialized’ by using the FORMAT (see 
Paragraph 3.2.8-B) program before transferring any program or data files to 
it). It is then possible to selectively add files to or erase files from that 
diskette as desired. To transfer or copy the desired files onto the diskette, 
use the SAVE command, the PIP utility, or a higher level language. 

NOTEs Do NOT format the VECTOR 4 CP/M System diskette or any other 
diskette containing desired information. Formatting completely erases a 
diskette. 

B* Hard Disk Copy 

To generate an operating system on the 5 Mbyte hard disk system, see 
Paragraph 3.2.1-B. 


1.4 DISKETTE BACKUP. REPLACEMENT. AND PROTECTION 

As with any magnetic storage medium, the recording gradually deteriorates over 
time. Even if a diskette is not damaged, it will begin producing errors after a 
very long period of use. 

A* Backup 

The best method for insuring against loss of diskette-based data is to maintain 
a backup diskette for each diskette you use. In the business world, this is 
considered dogma. Copy a diskette onto its backup whenever you cannot 
afford to lose the information stored since you last backed it up; this goes for 
programs as well as data. If you are operating business programs such as 
Inventory or Accounts Receivable, maintain a regular backup schedule, once a 
week In addition, a transaction journal, i.e., a printed copy of entries made 
each day into the system, is an excellent idea to build into business software 
as a ’last resort’ backup. 
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2a. Replacement 

In addition to being backed up, replace frequently used diskettes by copying 
each to a fresh diskette every six months. A good suggestion is to use the 
backup diskette, which is fairly fresh, as the new front-line diskette, and to 
create a fresh backup. Do not wait until a frequently used diskette fails 
before you replace it with the backup. To create backup diskettes (i.e., to 
copy diskettes) use the DISKCOPY utility. 

Qa. Protection 

Write-protect tabs come in boxes of new diskettes; if you attach a tab over 
the write-protect cutout on a 5 1/ 4-inch diskette, the disk drive will not allow 
you to erase or change any information on the diskette. The tab may be 
removed later, if required. 

L5 HANDLING ER RO RS 

Bad sector disk errors refer to errors reported on the screen (when CP/M is 
running) as: 

ERROR - driveK error message> 

indicating something is wrong with the diskette, the drive, or the disk controller 
board. There are several error situations which the Basic Disk Operating System 
(BDOS) intercepts during file processing. When one of these conditions is detected, 
the BDOS prints the message: 

ERROR - driveKerror> 

where <error> is the one of the following messages: 


PISS REA D/WRlTE(xxyy) 

The DISK READ/WRITE message will occur when the disk controller 
electronics has detected an error condition in reading or writing to the 
diskette ('xx* is a hex’ code denoting the particular physical BIOS error 
detected by the physical disk driver; ’yy* corresponds to the BDOS physical 
and logical error codes). This condition is generally due to a malfunctioning 
in the disk controller or the result of an extremely worn diskette. 
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If your system reports this error more than once a month, it may require 
servicing or your media may need replacement. Recovery from this condition 
may be accomplished by responding to the next prompt: 

PRESS rCTRL Cl TO REBOOT OR f RETURN 1 TO CONTINUE 

If a [CTRL C] is entered, the current program will be aborted and control 
returned to the CCP *; if a [RETURN] is entered, the error will be ignored 
by the program and execution will continue normally. Pressing [RETURN] 
would only be used when copying a file (using PIP), when it is mandatory that 
as much of the file is recovered as possible. Note, however, that entering a 
[RETURN] may destroy diskette integrity if the operation is I a directory write;' 
therefore, make sure an adequate backup has been made. 


* See Section 1.6.2 for a description of the CCP. 

NOTE: The following BDOS errors will display the particular error message and 

simply wait for user input to reboot; entering any key will cause a warm boot. 

DRIVE SELECT/ 

The DRIVE SELECT message will occur when there is an attempt to access a 
drive that is not supported by the current hardware/software configuration. In 
this case, the drive which is out of range is displayed along with the error 
message. The system reboots following any input from the terminal. 

DISK IS READ-ONLY 

The DISK READ-ONLY message will occur when there is lan attempt to write 
to a diskette which has been designated as ’READ/ONLY’ using the STAT 
command, or has been set to ’READ-ONLY’ by the BDOS. In general, the 
user should warm boot the system, using [CTRL C], whenever physically 
changing a diskette. If a changed diskette is ! to be read but not written to, 
the system allows the diskette to be changed without requiring a warm boot, 
but internally marks the drive as Read-Only. The status of the drive is 
subsequently ' changed back to ’Read/Write’ following a warm boot. Upon 
displaying the READ-ONLY message, CP/M waits for an input from the 
terminal; an automatic warm boot will occur following any user input. 
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FILE IS READ-ONLY 

The FILE READ-ONLY message will occur when there is ’an attempt to write 
to a file which has been declared as f R/0’ using the STAT command or by an 
applications program, or if the file islopened in READ-ONLY mode. The file 
may be returned to READ/WRITE status using the STAT command, if 
necessary. 

FILE CURRENTLY OPEN 

The FILE CURRENTLY OPEN message will occur if an attempt is made to 
access a file which is in use and locked by another user. 

ILLEGA L F ILE ACCESS 

The ILLEGAL FILE ACCESS message will occur when an attempt is made to 
access a file that is not open. 

FILE ALREADY EXISTS 

The FILE ALREADY EXISTS message will occur when a user or program is 
trying to create, rename, or spool a specific file which already exists on disk. 

ILLE G A L 12 1 IH FCB 

The ILLEGAL ’?’ IN FCB message will occur when a question mark '?’ is used 
within the File Control Block (FCB) in any file function other than SEARCH 
FIRST, SEARCH NEXT, and DELETE FILE. 

FILE OPEN LIST FULL 

The FILE OPEN LIST FULL message will occur when an attempt is made to 
OPEN or CREATE a file and the System File List is full (32 files maximum - 
list is maintained by the operating system of open files in the system, the 
task(s) which have the files open, and the mode in which the file is open). 

RECORD LOCK LIST FULL 

The RECORD LOCK LIST FULL message will occur when an attempt is made 
to LOCK a record and the Record Lock List is full (512 maximum - series of 
lists linked to the open file entries of the System File List describing which 
records are locked, and which task has them locked). NOTE: records can 

only be locked while in unlocked mode. 
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DRIVE NOT READY 

The DRIVE NOT READY message will occur when an attempt is made to read 
from a drive and the disk is either not properly seated or there is no disk in 
the drive. 

If any of the above errors occur, repeat the procedure that resulted in the error. 
If the error occurs again, refer to the section below on recovery techniques. If 
you consistently get such disk errors, switch to another of the suggested brands of 
diskettes. Try this before obtaining hardware service; if the errors persist, contact 
your service representative. 

If you repeatedly get bad sector disk errors using 'one particular diskette, then it is 
probably defective. This will sometimes happen with a new diskette when you are 
reformatting it or using it to back up another diskette. After several attempts, 
discard it or return it if possible. Whenever you repeat a disk operation after an 
error, always unload and reload the diskette, because it may be seated incorrectly. 

If an old diskette repeatedly gives bad sector errors, first repeat the operation 
several times, unloading and reloading the diskette each time. If there is still a 
problem, check the center hole. If it is wrinkled, straighten it out with your 
fingers and then try again. If you still get bad sector errors, try copying the 
diskette to another diskette using the DISKCOPY utility in CP/M. If the error still 
occurs, try switching source and destination drives. Some combination of drives and 
repositioning of diskettes within drives will often result in a successful copy. If 
you cannot copy a diskette at all, then copy it file by file to another initialized 
diskette using the PIP utility. There may be one or two files which will not copy, 
but hopefully all the other files will copy over successfully. 

When you gfet a bad sector error message, CP/M allows you to skip over the bad 
sector and continue the operation. This is not usually desireable because the bad 
data will cause other problems. However, if there is no other way to get the file 
off the diskette intact, simply bypass the error message by pressing the [RETURN] 
key immediately after the bad sector error message occurs. The disk operation will 
continue, ignoring the fact that a bad sector was transferred. 


1.6 D ESC R IET1QIL. Q E V E CTO R.. 4 CP/M 


1*5*1 General 

VECTOR 4 CP/M is a high-performance operating ' system which uses table driven 
techniques to allow field configuration to match a wide variety of disk capacities. 
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All of the fundamental file restrictions are removed, while maintaining upward 
compatibility from previous versions. The directory size can be field configured to 
contain any reasonable number of entries, and each file is optionally tagged with 
READ-ONLY and READ/WRITE system attributes. Users of CP/M can physically 
separate groups of files by user areas, with facilities for file copy operations from 
one user area to another. Powerful relative-record random access functions are 
present in CP/M which provide direct access to any of the 65536 records of an 
eight megabyte file. 

In the VECTOR 4 CP/M environment, the user is given a separate bank of memory 
to use exclusively. Within each drive, the user has access to 16 user areas (0 
through 15). These user areas are accessed in the very same manner as accessing a 
different drive; i.e., to change drives, the user simply enters which drive is 
required: 

A>B: 

which equates to moving from Drive A to Drive B. In the same way, the user can 
change user areas by entering which user area number is wanted; e.g.: 

A>USER 5 

which moves the user from the current user area (usually User 0 since CP/M boots 
into User 0) to User 5. 

Although a computer can only perform a single operation at a time, it operates at 
such high speed that it can service several tasks at one time (using the background 
printing feature); this is done by switching between tasks, giving a portion of time 
(called a time slice) to both tasks. When that task's time slice is used up, the 
system willisuspend the operation of that task and allow the other task to have a 
time slice. This time slice operation happens constantly between both tasks or 
tasks on the system; however, because a computer operates at very high speeds, 
this sharing of time is generally transparent to the user. A task may lose its time 
slice if, for any reason, it is waiting for an input or output process to complete, or 
if it is waiting for a shared resource, such as a printer. 

The purpose of VECTOR 4 CP/M is to execute commands and allow the user 
convenient access to all of the hardware and software resources provided by the 
computer. CP/M provides rapid access to programs through a comprehensive file 
management package. The file system supports a named file structure, allowing 
dynamic allocation of file space as well as sequential and random file access. 
Using this file system, a large number of distinct programs can be stored in both 
source and machine executable form. 
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The part of the operating system that switches (swaps) tasks is called the 
scheduler. The scheduler is responsible for saving all the registers, the stack 
pointer, and program counter of the current task into the Task Control Block 
(TCB). The scheduler will look for a task that is ready to run and, once found, 
willtreload all the registers with the values that were saved for that task when it 
was swapped out. If, while the scheduler is looking for a task that is ready to 
run, it finds a task that is waiting for an event to occur, the scheduler will check 
to see if the event has occured, and if it has, the task’s status will be set to 
ready. 

When the Vector system is turned on, or powered up, the following banner and 
prompt will display on the screen: 


JVBCTCB 1 SB C L 




LLli 


SBO 

VECTOR 4 CP/M, once booted, will display the following messages on all terminals: 

VECTOR 4 CP/M - VERSION 1.9 
PRINTER 1 LOADED WITH x 
PRINTER 2 LOADED WITH x 

A> 

where ’x’ is equivalent to one of the following printer driver messages, depending 
on what kind of printer is available and what printer configuration has been enabled 
(through the CONFIG P or CONFIG program): 

A DRAFT DRIVER 
A WORD PROCESSING DRIVER 
NO DRIVER 
AN UNKNOWN DRIVER 

The following is a typical display after enabling the printer drivers: 

VECTOR 4 CP/M - VERSION 1.9 

PRINTER 1 LOADED WITH A DRAFT DRIVER 

PRINTER 2 LOADED WITH A WORD PROCESSING DRIVER 

A> 
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1.6.2 Sys tem Division 

CP/M is logically divided into four distinct areas, the lower portion of memory is 
reserved for system information: the Basic I/O System (BIOS), the Basic Disk 

Operating System (BDOS), the Console Command Processor (CCP), and the Transient 
Program Area (TPA). 

The CCP provides the interface between the user’s console and the remainder of 
the CP/M system. The user interacts with CP/M primarily through the CCP, which 
reads and interprets commands entered through the console. The CCP reads the 
console device and processes commands which include listing the file directory, 
printing the contents of files, and controlling the operation of transient programs, 
such as assemblers, editors, and debuggers. The CCP will also close and release 
any open user files when necessary. It is a distinct program which uses the BDOS 
and BIOS to provide a human-oriented interface to the information which is 
cataloged on the backup storage device. 

In general, the CCP addresses one of several drives which are on-line (the standard 
system addresses up to four different disk drives). These disk drives are labeled A, 
B, C, and D. A drive is ’logged-in' if the CCP is currently addressing that drive. 
In order to clearly indicate which drive is the currently logged drive, the CCP 
always prompts the operator with the drive name followed by the symbol ’>' (e.g., 
’A>') indicating that the CCP is ready for another command. Upon initial start up, 
the CP/M system is brought in from Drive A and will display the following message: 

VECTOR 4 CP/M VERSION 14 

Following the system sign-on, CP/M automatically logs into Drive A, prompts the 
user with the ’A>’ prompt (indicating that CP/M is currently addressing Drive A), 
and waits for a command. The commands are implemented at two levels: resident 

commands and transient commands. Resident commands are a part of the CCP 
program itself, while transient commands are loaded into memory (the TPA) from 
disk and executed. 

The BDOS provides disk management by controlling one or more disk drives 
containing independent file directories. The BDOS implements disk allocation 
strategies that provide fully dynamic file construction while minimizing’ head 
movement across the disk during access. Any particular file may contain any 
number of records, not exceeding the size of any single disk. The BDOS has entry 
points which include the following primitive operations which can be 
programmatically accessed: 

SEARCH Look for a particular disk file by name. 
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OPEN 

CLOSE 

RENAME 

READ 

WRITE 

SELECT 


Open a file for further operations. 

Close a file after processing. 

Change the name of a particular file. 

Read a record from a particular file. 

Write a record onto the disk. 

Select a particular disk drive for further operations. 


The BIOS provides the primitive operations necessary to access the disk drives and 
to interface with standard peripherals (CRTs, Serial Terminals, and Printers). The 
BIOS is a hardware-dependent module which defines the exact low-level interface to 
a particular computer system which is necessary for peripheral device I/O; it also 
provides the user the interface to the multitasking environment within VECTOR 4 
CP/M. 


The TP A . the last segment of CP/M, is the area called the Transient Program Area. 
The TPA is an area of memory (i.e., the portion which is not used by the BDOS, 
BIOS, and CCP) where various non-resident operating system commands and user 
programs are executed. The TPA holds programs which are loaded from the disk 
under command of the CCP. During program editing, for example, the TPA holds 
the CP/M text editor machine code and data areas. Similarly, programs created 
under CP/M can be checked out by loading and executing these programs in the 
TPA. The user communicates with the CCP by entering command lines following 
each prompt. Each command line takes one of the following forms: 

Command 
Command fUel 
Command filel file2 
.Command filel f£Le2 


where ’Command 1 is either a resident function, such as DIR or TYPE, or the 
filename of a transient command or program, such as PIP or CONFIG. If the 
command is a resident function of CP/M, it is executed immediately; otherwise, the 
CCP searches the currently addressed disk for a file by the name 
’<Command>.COM’. If the file is found, it is assumed to be a memory image of a 
program which executes in the TPA. The CCP loads the COM file from the disk 
into memory. The transient program receives control from the CCP and begins 
execution; the program is ’called’ from the CCP and, therefore, will simply return 
to the CCP upon completion of its processing. 
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If the user is in a user area other than User 0, but the program being called is on 
User 0, the operating system will pull the program from User 0 into the current 
user area and begin execution. Data files created or edited within the current user 
area will be saved on that user area. If, however, the user wants to work within 
User 0 and is currently in another user area, the ’dot’ command can be used to 
work within User 0, saving data files within User 0, while actually residing in the 
current user area. For example: 

A>USER 5 Change from User 0 to User 5 

A>DIR Call the directory of Drive A, User 5 

A>.DER Call the directory of Drive A, User 0 

This facility allows the user to work within different user areas and, depending on 
where the data files are to reside, store files in either area, without ever leaving 
the current user area (as in the example above, User 5). 

It should be reiterated that the VECTOR 4 CP/M operating system is partitioned 
into distinct modules, including the BIOS portion which defines the hardware 
environment in which CP/M is executing. Therefore, the system can be easily 
updated to any standard environment. 

Several CP/M modules and utilities have improvements that correspond to the 
enhanced file system. STAT and PIP both account for file attributes and user 
areas, while the CCP provides a log-in' function to change from one user area to 
another. The CCP also formats directory displays in a more convenient manner and 
accounts for both CRT and hard-copy devices in its enhanced line editing functions. 


l«g.3 -liig Description 

Nearly all of the commands reference a particular file or group of files. A file 
reference identifies a particular file or group of files on a particular disk attached 
to CP/M. These file references can be either an ’unambiguous filename’ (ufn) or an 
’ambiguous filename’ (afn). An unamabiguous file reference uniquely identifies a 
single file, while an ambiguous file reference may be satisfied by a number of 
different files, when using ’?’ or either in the filename or the extension. 

File references consist 'of two parts: the filename and the extension. Although the 

extension is optional, it usually is generic; ithat is, the extension ’.ASM’ is used to 
denote that the file is an assembly language source file, while the filename 
distinguishes each particular source file. The two names are separated by a period 
(.); e.g., ffffffff.eee where ’f’ represents the filename of up to eight characters, 
and ’e* represents the extension consisting of three characters. 
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The characters used in specifying an unambiguous file reference cannot contain any 
of the following special characters: 

<>.,;: = ?*[] 

while all alphanumerics and remaining special characters are allowed. 

An ambiguous file reference is used for directory search and pattern matching. The 
form of an ambiguous file reference is similar to an unambiguous reference, except 
the symbols ’?’ and '*' may be interspersed throughout the filename and extension. 
In various commands throughout VECTOR 4 CP/M, the '?' matches any character of 
a filename in the '?' position, and the asterisk '*' matches any characters of a 
filename from that particular position on in the field; e.g., C*.COM would be 
equivalent to C???????.COM. Therefore, the ambiguous reference 'AB*.C?M' is 
satisified by the unambiguous filenames 'ABCD.COM' and 'ABCDEFGH.CAM'. Note 
that the ambiguous reference '*.*' is equivalent to the ambiguous file reference 
'????????.???’, while ’ffffffff.*’ is equivalent to 'ffffffff.??? and ’*.eee' is 
equivalent to *????????. eee'. However, 'ABC*. ASM’ is equivalent to 
'ABC?????. ASM' where »ABC?.ASM' is equivalent to ’ABC?####.ASM’, where 
'#’ = a space, not a character. 

As an example, 'DIR *.*' is interpreted by the CCP as a command to list the 
names of all disk files in the directory, while 'DIR X.Y’ searches only for a file by 
the exact name 'X.Y'. Similarly, the command 'DIR X?Y.C?M’ causes a search for 
all unambiguous file names on the disk which satisfy this ambiguous reference. The 
following file names are valid unambiguous file references: • 

X XYZ GAMMA X.Y XYZ.COM GAMMA.1 

As an added convenience, the user can generally specify the disk drive name along 
with the filename. In this case, the drive name is given as a letter (A through Z) 
followed by a colon (:); e.g., A>B:<filename.ext>. The specified drive is then 
'logged-in' before the file operation occurs. Thus, the following are valid filenames 
with disk name prefixes: 

A:W.Y B:XYZ CiGAMMA Z:XYZ.COM B:X.A?M D:*.ASM 

It should also be noted that all alphabetic lower case letters for drives and 
filenames are always translated to upper case when they are processed by the CCP. 

Since it is possible for ’the user to switch the currently logged disk by entering the 
disk drive name (A, B, C, or D) followed by a colon (:) when the CCP is waiting 
for console input, the following are possible examples in a sequence of prompts and 
commands: 
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A>DIR (Lists an files on Drive A) 

SAMPLE ASM 
SAMPLE PEN 
A>Bj (Switches to Drive B) 

B>Dm *»ASM (Lists all ’.ASM* files on Drive B) 
DUMP ASM 
SAMP LEI ASM 
TEST3 ASM 

B>A: (Switches back to Drive A) 

A>DER Bs (Lists all files on Drive B) 


LSA gfla-Canajmctton 

CP/M files are constructed from basic building blocks called ’records'. A record is 
a 128-byte block of data containing either program object code, program data, or 
text. A file is, therefore, simply a number of these records which are grouped 
together and given a name. Since a file can have a very large number of these 
records in it (up to 85,536 records in each file), CP/M must impose a higher level 
of internal structure to manage all of the records in a file. This is achieved by 
using a logical data block called an 'extent' consisting of 128 records (16,384 bytes 
of data). Therefore, any CP/M file is comprised of at least one or more extents; 
these are used by CP/M to keep track of where all the records of a file are 
located on a disk. 

Since there are many sectors on a disk, CP/M could store a 128-byte record in any 
number of places on the disk. In order to keep track of where these sectors are, 
the diskette is broken up into ’allocation blocks', the size depending on the disk 
configuration (may be from IK to 16K in length). Then, if a file needs more space 
to write more records* to, a full mew allocation block is assigned to it even though 
only 128 bytes (1 record) may actually be used. Each directory entry can have 8 
or 16 allocation blocks assigned to it. The number of each allocation block 
assigned to- a directory entry is stored in one or two bytes within field 7 of the 
File Control Block (FCB). See Sections 4.2 and 4.3 < for a complete description of 
FCB and allocation blocks. 
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CP/M keeps a master list in memory of all of the assigned allocation blocks 
currently assigned to a file along with all the unused allocation blocks. Whenever a 
new allocation unit is required by a file, CP/M will take the next available 
allocation unit, delete it from the unused list, and add it to the FCB of the file. 
These lists are read into the BDOS from the diskette the first time the diskette is 
accessed after a warm boot. By assigning new allocation blocks to files as they 
get larger, and reclaiming allocation units as files get smaller or are erased 
altogether, CP/M can dynamically manage all of the file space on a diskette, and a 
file's data can be spread across the disk in randomly located sectors. 

The -final step used by CP/M to keep track of the files on a diskette is the 
directory. CP/M stores the directory information in the beginning of the data 
storage area of the diskette. A directory entry may contain multiple extents. This 
depends on allocation block size and the total number of blocks a drive can 
accomodate. Therefore, a file with more than one extent may have multiple 
directory entries. Hence, although a 'DIR' command is entered, only the first 
directory entry for each file is displayed. The format of the directory entry is the 
same as the FCB except for the following fields: 

Field 1: User number Q-xx. E5 means file is deleted 

Fields 9-11: el', e2', e3’ are set according to file type. 

Field 12: Gives maximum extent number. 

Field 13: Mod number equals 0. 

Fields 32-35: Not used. 

Therefore, whenever a file is accessed through CP/M, its FCB is brought into the 
TP A so that it can be accessed quickly and conveniently. Any changes or updates 
to a file by the user will automatically be updated to the FCB by CP/M. 

Random access facilities are present in CP/M which allow immediate reference to 
any record of an eight megabyte file. Using CP/M's unique data organization, 'data 
blocks are only allocated when actually required and movement to a record position 
requires little search time. Sequential file access is upward compatible from earlier 
versions to the full eight megabytes, while random access compatibility stops at 
512 Kbyte files. Due to CP/M's simpler and faster random access, application 
programmers are encouraged to alter their program to take full advantage of the 
facilities. 
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SECTION R - RESIDENT COMMANDS 


2.1 INTRODUCTION 

VECTOR 4 CP/M will execute two types of commands: resident and transient. 

Resident commands are those commands whose instructions are permanently resident 
in the CCP and may be used at any time. Transient commands are those commands 
whose programs are stored on a disk, are then loaded into the TP A from the disk 
and executed. CP/M provides the user with several resident commands which may 
be interpreted and immediately executed by the CCP when invoked by the user. 


2.2 


CCP LINE £ 




G AND OUTPUT CONTROL 


The CCP allows certain line editing and output functions while entering command 
lines. 


A* Line Editing 

[BACKSPACE] or 

[DEL] Deletes the last character entered at the terminal. 

[CTRL U] Ignores the entire line entered at the terminal, keyboard entry 

continues on a clean command line. 

[CTRL X] Deletes the entire line enterered at the terminal, keybaord 
entry continues on same line. 

[CTRL R] Redisplays current command line, keyboard entry continues at 
the end of the redisplayed command line. 

[CTRL C] CP/M system reboot (warm start). 

[CTRL D] Clears the screen before executing any CCP command; must be 
entered before the command. 


[CTRL Z] 


Ends input from the terminal (used in PIP). 
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B* OUTPUT CONTROL 


[CTRL P] Copies all subsequent console output to the currently assigned 
list device (see the STAT command). Output is sent to both 
the list device and the terminal until the next [CTRL P] is 
entered. 


[CTRL K] Sends a form feed to the currently assigned list device; :if no 
device is assigned, the [CTRL K] will be ignored. 

[CTRL S] Stops the terminal output temporarily; program execution and 
output continues when any key, except [CTRL C], is entered at 
the terminal. This feature is used to stop output on high 
speed terminals, such as CRTs, in order to view a seginent of 
output before continuing. 


Note that the [CTRLHcey sequences are executed by depressing the Control 
([CTRL]) key and the desired letter key simultaneously. Further, CCP 
command lines can generally consist of up to 127 characters in length; they 
are not acted upon until a [RETURN] is entered. 


2.3 B ESPSN1... C OMMAMDS 

Resident commands are a part of the CCP program itself, while transient commands 
are loaded into the TPA from disk and executed. The resident commands consist of 
the following: 

ERA Erases specified files. 

DER Lists fEe names in the directory. 

REN Renames the specified fEe. 

SAVE Saves memory contents in a fEe. 

TYPE Types or displays the contents of a file to the terminal. 

TPA Calls address 10 j5H in user's memory. 
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BSPL Begins Spooler. 

ESPL Ends Spooler. 

DSPL Activates Despooler to print a specified spooled file. 

KSPL Aborts the Despooler. 

BYE Performs a cold boot process. 

The following are Primitive Resident Commands. Originally they were available 
through the use of the system monitor program. They are now accessible through 


the CCP. 

FILL Fills memory with constant 

FIND Finds a code sequence in memory. 

DISP Displays memory in hex and ASC1L 

GOTO Starts execution at given address. 

PROG Programs memory. 

INP Inputs from CPU port. 

OUT Outputs to port. 

COMP Compares two blocks of memory. 

MOVE Moves a block of memory. 

CHEK Computes checksum of memory. 

XCOM Mindless Terminal Emulator/loop back tester. 

The file and device references described before can now be used to fully specify 

the structure or format of the resident commands. 
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2.3.1 ERA Command 

The ERA (erase) command will remove files from the currently logged disk or 
another specified disk. The files which are erased are those which satisfy the 
ambiguous filename (afn). The following examples illustrate the use of the ERA 
command: 


ERA X.Y The file named ’X.Y’ on the currently logged disk is removed 
from the disk directory, and the space is returned. 

ERA X.* All files with a filename ’X’ are removed from the current 

disk. 


ERA *.ASM All files with the extension of ’ASM’ are removed from the 
current disk. 

ERA X?Y.C?M All files on the current disk which satisfy the ambiguous 
reference X?Y.C?M are erased. 

ERA *.* All files on the current disk are erased (in this case, the CCP 

prompts the user with the message ’ALL FILES (Y/N)?’ which 
requires a ’Y’ response before files are actually erased). 


ERA B:*J?RN All files on Drive B which have an extension of ’.PRN’ are 
erased, independently of the currently logged disk. 


2-3.2 DIR Command 

The DIR (directory) command will cause the names of all files on the currently 
logged disk which satisfy the ambiguous filename (afn) to be listed at the 

terminal (the command 'DIR’ is equivalent to the command ’DIR *.*’). Following is 
a list of valid DIR commands: 


DIR X.Y 
DIR X?Z.C?M 
DIR *.Y 


Lists the unambiguous file ’X.Y’. 

Lists all ambiguous files matching the specified reference. 
Lists all ambiguous files with an extension of ’Y’. 
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Similar to other CCP commands, the afn can be preceded by a drive name. The 
following DIR commands cause the selected drive to be addressed before the 
directory search takes place: 

DIR B: Lists all files on Drive B. 

DIR B:X.Y Lists the file ’X.Y’ on Drive B. 

DIR B:*.A?M Lists all ambiguous files matching the specified reference on 
Drive B. 

If no files can be found on the selected disk which satisfy the directory request, 
the message ’NOT FOUND’ is displayed on the terminal. 


2«3«3 BEN Command 

The REN (rename) command will allow the user to change the names of files on 
disk. The command format is ’REN unfl=unf2' where unfl is the name of the new 
file and unf2 is the name of the old file. Following are examples of the REN 
command: 

REN X.Y=Q.R Renames the file ’Q.R’ to ’X.Y’. 

REN Y .COM=Y .MEM Renames the file ’Y.MEM’ to ’Y.COM’. 

The user can precede either ufnl or ufn2 (or both) by an optional drive name. 
When one of the files is preceded by a drive name, then the other is assumed to 
exist on the same drive. If both files are preceded by drive names, the same drive 
must be specified in both cases. Following are examples of the REN command: 

REN A:X.ASM=Y .ASM Renames the file ’Y.ASM' to ’X.ASM’ on Drive A. 

REN B:XJ3AS=ZJ3AS Renames the file ’X.BAS’ to ’Z.BAS’ on Drive B. 

REN A:A.ASM=B:A.BAK Renames the file ’A.BAK’ on Drive B to ’A.ASM’ on 

Drive A. 

If the ufnl already exists, the message ’FILE EXISTS’ will display and the change 
will not occur. If ufn2 does not exist on the specified disk, the message 'NOT 
FOUND’ will display on the terminal. 
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2,3.4 SAVE Command 


The SAVE command places ’n’ pages (256-byte blocks) onto disk from the TPA and 
names this file with a specified ufn. In the CP/M distribution system, the TPA 
starts at 100H (hexadecimal), which is the second page of memory; therefore, if the 
user’s program occupies the area from 100H through 2FFH, the SAVE command must 
specify two (2) pages of memory. The machine code file can be subsequently 
loaded and executed. The SAVE command can also specify a disk drive in the afn 
portion of the command. Following are examples of the SAVE command: 


SAVE 3 X.COM 
SAVE 40 C 


SAVE 4 X.Y 


Copies 100H through 3FFH to a file named ’X.COM’. 

Copies 100H through 28FFH to a file named ’C’ 
(note that 28 is the page count in 28FFH and that 
28H = 2x16+8 = 40 decimal). 

Copies 10 0H through 4FFH to a file named ’X.Y’. 


SAVE 10 BsZOT.COM 


Copies 10 pages (100H through 0AFFH) to a file 
named ’ZOT.COM’ on Drive B. 


2.3.5 TYPE Command 


The TYPE command displays the contents of a specified ASCII source file (ufn) on 
the currently logged disk at the terminal. This command expands tabs ([CTRL L] 
characters) assuming tab positions are set at every eighth column. The command 
can also reference a drive name before the ufn. Following are examples of the 
TYPE command: 


TYPE XZZJMEM | 

I 

TYPE ABC.EPL > Types the specified file on the terminal. 

I 

TYPE XXXJ^ai 1 


TYPE B:XJ?RN 


’ Types the specified file on the terminal from Drive B. 
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2.3.6 TP A Command 

The TPA (Transient Program Area) Icommand will 'jump 1 the user to address 100H in 
the user’s memory and execute the program at that location; i.e., to go back into 
memory if, for instance, the user forgot to save the current file or unintentionally 
exited from a program. The command line format consists of either of the 
following: 

TPA 

or 

TPA driveifilename 

WARNING: Not all programs may be re-entered successfully after exiting; consult 

your program User’s Manual or Manufacturer for more information. 


2»3.7 BSPTi Command 

The BSPL command will begin the spooler function and send all subsequent printer 
characters to a specified file. Following is the command format: 

BSPL driverfILename (must be ufn) 

NOTE: Characters sent to printer via the BIOS will not be spooled; only 

characters sent through BDOS function 5 will be spooled (most programs use 
function 5 for printer output). BSPL will detach any attached list device before 
spooling. 

After the command is entered, one of the following messages will display on the 
terminal giving the status of the spooler: 

SPOOLER ACTIVATED Spooler has been successfully activated. 

SPOOLER ALREADY ACTIVE Spooler has already been activated and is 

ready. 
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FILE EXISTS 

DIR FULL 
ILLEGAL FILENAME 

d:DRIVE SELECT 


Spooler is refusing' to work with an existing spooled 
file. 

No room left in directory. 

Filename specified either does not exist or has 
illegal characters in the entry. 

Drive specified is bad, where 'd:' is the specified 
drive in the command line. 


2-3.3 ESPL Command 

The ESPL command will close the spooler file and deactivate the spooler. The 
spooler will not close after a warm boot, it will remain open; therefore, this 
command must be executed when the user no longer wants the printer information 
to go to the spooler file. After the command is entered, one of the following 
messages will display on the terminal giving the status of the end-spooler attempt: 


SPOOLER CLOSED Spooler has been closed successfully. 

SPOOLER NOT ACTIVE Spooler has already been deactivated, or if the 

spooler gets an I/O error of some sort. 


BAD WRITE Spooler encounters a disk I/O error when trying to 

write the last sector. 

CLOSE ERROR Spooler encounters a problem writing to the 

directory or trying to spool to a deleted file. 


2 . 3.9 DSPL Command 

The DSPL command will despool a specified file to a specific print device. The 
format of the command line is as follows: 

DSPL n< drive:f Rename 

* 

where *n' is the print device (either ’1 ? or T 2 T ), '<' will optionally turn on the 
’auto-paging' function, and the filename must be unambiguous. The despooler runs 
in 'background', i.e., the despooler may be printing to the list device and the user 
can continue with some other task, such as editing another file. 
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After the command is entered, one of the following messages will display on the 
terminal giving the status of the despooler attempt: 

DESPOOL ACTIVATED Despooler has been activated successfully. 

DESPOOL ALREADY ACTIVE Despooler has been asked to work on more than 

one file at a time. 

NO FILE Despooler cannot find the specified file on that 

disk, or the file has not yet been spooled. 

BAD FILE NAME File is either blank or has an afn specification; 

file must be -an ufn. 

Printer number is invalid, or the printer is busy. 

Drive specified is bad, where T d:' is the specified 
drive in the command line. 

PRINTER BUSY Desired list device is in use by another task 

(user or despooler). 

2.3.1Q SSPL Command 

The KSPL command will abort, or prematurely stop, the operation of the despooler; 
the despooler will turn off normally once the specified file has been printed. After 
the command is entered, one of the following messages will display on the terminal 
giving the status of the abort attempt: 

DESPOOL ABORTED Despooler has been aborted successfully. 

DESPOOL NOT ACTIVE Despooler is not active so cannot be aborted. 

NOTE: The Despooler will U£3l expand tabs or initialize pagination control; it will 

send characters to the printer exactly as they are in the file. 


INVALID PRINT DEVICE 
dsDRIVE SELECT 
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2.3.11 BY E Command 

The BYE command will perform a cold boot procedure executing functions beyond a 
warm boot ([CTRL C]) procedure. Following is a list of both warm boot and cold 
boot functions performed by the BYE command: 

Warm. Boot functions; 

• Release File and Record Resources (function 255) 

• Reset Keyboard buffering and conversions (function 241, 242) 

• Set Error mode to default (function 226 or 45) 

• Execute warm boot Auto-Command 

C<?ld Boot functions., provided by ,.BY.E command; 

• Reset BDOS base (function 246) 

• Clear Cross-Bank calls (function 245) 

• Clear Auto-Paging (function 243) 

• Release (detach) List Device (function 159) 

• Execute Cold Boot Auto-Command 

• Set Default Key Conversion (function 219) 

• Enable [CTRL C] Warm Boot (function 217) 


2*2*12 Primitive Resident Commands 

These commands are functionally similar to the commands used by Vector Graphic 
system monitor programs. They have been added to the resident command structure 
within the CCP. The ’command line format is given for each command; however, if 
only the command is given with nothing following, prorapt(s) for the missing 
information will be given. 
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Ajl FILL Command 

The FILL command will place a single byte instruction or datum in the memory 
block between the start and end address. This can also be useful for setting 
memory to zero to make the end of a file or assembled program to stand out more 
clearly. For test purposes, single instructions can be executed continuously so that 
bus waveforms can more easily be interpreted; this is done by filling a block of 
memory with a repeated instruction sequence with a juipp to the start of the block 
enabling the program to loop continuously.* The format of the command line 
consists of the following: 

FILL <Start Address (4 hex)> <End Address (4 hex)> <Data (2 hex)> 

NOTE: An error will 'result if a FILL to "common RAM" (FCOOH-FFFFH) is 

attempted. 

S* FIND Command 

The FIND command willtsearch for a particular code sequence of up to 63.5 bytes 
in length in the range between the start and end address. This command is useful 
for locating a code sequence of jump address, text strings, etc. For example, if 
you want to change a control character (e.g., [CTRL C]) in a program, you can try 
’FE 03’, which is 'CPI 03’ since this is a common way of testing input characters. 
If you want to find all locations that call or jump to a particular address, C700H 
for example, simply search for ’00C7’; however, there is no guarantee that each 
location displayed is valid object code — it may be part of a data table, ASCII 
string, or second and third bytes of a three-byte instruction. Wildcards are 
available with the FIND command and consist of ’?' and ’X’, both equal to one 
nyble. The format of the command line consists of the following: 

FIND <Start Address (4 hex)> <End Address (4 hex)> < Sequence (X(2 hex))> 

Gm. PISP Command 

The DISP command will display the memory contents between the start and end 
address as pairs of hexadecimal characters. The left character in each pair 
represents the four most significant bits of the memory location. The ASCII 
representation will also be displayed on the right. The display may be halted or 
interrupted by pressing [CTRL S] and continued by pressing any key except 
[CTRL C]. Pressing [CTRL C] will abort the display or entry. The format of the 
command line consists of the following: 

DISP <Start Address (4 hex)> <End Address (4 hex» 
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D>. GOTO Command 

The GOTO command will cause a call to the specified start address to execute a 
program or user subroutine. The address contained on the stack is the CCP 
RETCOM, and if the user routine at the address ends in ’RET’, program execution 
will return to the CCP; pushing more registers on the stack than are popped will 
defeat the return feature with undesirable effects. The format of the command 
line consists of the following: • 

GOTO <Start Address (4 hex)> 

Ea. PROG Command 

The PROG command will display the content of the byte of memory in the specified 
start address in hex; followed by a hyphen. The user can keep the current value 
and advance to the next byte by entering a [RETURN], or replace the existing 
contents by entering the appropriate hex byte. The current values for the memory 
segment will be displayed, and new values entered will replace the old values. A 
[RETURN] will cause the current memory location to be unaltered, while a 
[CTRL C] will i exit and save the contents. The format of the command line 
consists of the following: 

PROG <Start Address (4 hex)> 

INP Command 

The INP command will cause the CPU to display the contents of a specified port 
(2-byte hex; code). This command is useful in the checking of peripheral equipment. 
Those ports used by the terminal, cassette interface, etc. will contain a usable 
value; all others will read l FF’ since the data bus will be floating when the 
command is executed. The format of the command line consists of the following: • 

INP <Port (2 hex)> 

Qm. OUT Command 

The OUT command will output a two-byte hex; value or data to a specified port. 
This command is useful for checking out peripheral equipment; e.g., if a printer is 
connected to I/O port’ 6, the command line *OUT 06 41* will cause an 'A* to be 
printed ( t 41 t = the hex code for the ASCII letter ’A*). The format of the command 
line consists of the following: 

OUT <Port (2 hex)> <Value (2 hex)> 
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Um. COMP. Command 

The COMP command will make a byte-by-byte comparison of the block of memory 
data between the source start and end address and a block of identical length 
starting at the destination start address. Only the differences will be printed out 
with the address and the byte of the first block and the address and byte of the 
second block. This command is useful to compare two versions of a program or to 
verify that PROMs have been programmed correctly. The format of the command 
line consists of the following: • 

COMP <SBSA> <SBEA> <DBSA> 

where: 

SBSA = Source Block Start Address (4 hex) 

SBEA = Source Block End Address (4 hex) 

DBSA = Destination Block Start Address (4 hex) 

L M.QVE- Command 

The MOVE command will move the data contained in memory between the source 
start and end address to the memory location starting at the destination start 
address. This command is useful for moving a program from a temporary storage 
location to its correct address. This command can be useful for bank programming 
of PROMs, or for creating repeating instruction sequences for test purposes. The 
format of the command line consists of the following: 

MOVE <SBSA> <SBEA> <DBSA> 

where: 

SBSA = Source Block Start Address (4 hex) 

SBEA = Source Block End Address (4 hex) 

DBSA = Destination Block Start Address (4 hex) 

i CHEE Command 

The CHEK command will compute and display the MOD 256 checksum of the 
memory contents within v the specified start and end address range. This command is 
useful for checking proms or files to see if anything has changed. Any source file 
or program area of pure code (it does not write on itself) will have the same 
checksum as when it was loaded. While debugging assembly language programs, it 
is useful to be able to verify that a program being debugged has not written 
garbage in the source file or assembler. 
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The format of the command line consists of the following: • 

CHEK <Start Address (4 hez)> <End Address (4 hex)> 

Km. XCQM Command 

The XCOM Command will output anything typed at the keyboard through the serial 
port specified. Anything received from this serial port will be displayed on the 
screen. 

XCOM <port> Port = 4 or 6 (4 is default value) 
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SECTION HI - TRANSIENT COMMANDS 


3,1 INTRODUCTION 

Transient commands are programs, sometimes referred to as command files. A 
transient command, or program, can be executed by simply entering the filename, 
the .COM extension does not need to be entered in the command line; e.g., 
PIP.COM is a transient command and can be executed by entering ’PIP’ after the 
, A> t prompt. Transient commands are loaded from the currently logged disk and 
executed in the TP A. 

There are three logical divisions of transient commands: the Utility commands, the 

Programming commands, and the Test commands. This division of commands is 1 
initiated in this manual for ease of use and understanding. The transient commands 
defined for execution under the CCP are shown below, while additional functions 
can easily be defined by the user (see the LOAD command definition). 


Utility Commands 

GEN SYS Copies a VECTOR 4 CP/M operating system onto either 

initialized double-sided diskettes or a hard disk. 

CONFIG Creates a personalized system by setting up CP/M for the 

printer, enabling automatic page feed, creating an ’auto boot* 
command, and setting logical drive assignments, printer driver 
selection, boot options, and other assorted user options. 

SORTDIR Reads the directory from a specified disk, sorts the directory 
alphabetically, and writes the sorted directory back to the 
disk. 


EDIR Lists the names of all files in an alphabetically sorted 

directory (other options for a directory listing are also 

available) to the terminal, ending with the remaining space left 

on disk. 

* 

ERAX Erases, or deletes, specified files from the currently logged 

disk; ERAX has several options available for file deletion. 
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STAT 


PIP 


FORMAT 


Lists the number of bytes of storage remaining on the 
currently logged disk, provides statistical information about 
particular files, and displays or alters device assignment. 

Copies programs and files between disks and user areas, and 
also transfers files to or from logical devices, such as a 
printer or communication lines. 

Initializes a disk or diskette in order to ’save 1 or 'create* new 
files on the diskette; every new diskette must be 'formatted* 
before use, except for backup procedures using the DISKCOPY 
utility. 


DISKCOPY Creates a copy or backup of single and double sided diskettes. 

STORE Creates a backup of a hard disk with files exceeding the 

capacity of one floppy diskette but consisting of 5 Mbytes or 
less. 


RESTORE Retrieves the backup files created by STORE and returns them 
to the hard disk. 


Programming Commands 

SCOPE (SC) Accesses Vector's SCreen Oriented Program Editor, a program 
editor for Vector computers, to create and edit any CP/M 
ASCH file, either program text files or data files, and offers 
horizontal scrolling, large file size (limited only to the size of 
the disk), full control character display, and elimination of 
non-printing characters in the text. See Vector's SCOPE 
REFERENCE MANUAL for detailed information on using 
SCOPE. 

ZSM Loads the CP/M assembler and assembles a Z-80 assembly 

language text (source code) into a sequence of machine 
language instructions (object code) which can then be loaded 
into memory and executed. See the ZSM ASSEMBLER USER’S 
MANUAL for more detailed information. 

LOAD Loads the file in Intel 'hex' machine code format and produces 

a file in machine executable form which can be loaded into the 
TP A (this loaded program becomes a new command under the 
CCP). 
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SUBMIT 


XSUB 


DDT 


RAID 


DUMP 


GENLLST 


Submits a file of commands for batch processing; also allows 
chained batch commands, since the last command in a SUB file 
can initiate another SUB file. 

Extends the power of the SUBMIT facility to include line 
inputto programs, as well as the CCP, and, if needed, is 
included as the first command in a SUB file. 

Loads the CP/M debugger into the TPA and begins execution. 
Allows user dynamic interactive testing and debugging of 
programs generated in the CP/M environment. See the CP/M 
DYNAMIC DEBUGGING TOOL (DDT) USER’S GUIDE for more 
detailed information. 

Allows access to Vector’s RApid Interactive Debugger program 
which simulates a program step by step taking each 
instruction of the program, executing it, and displaying the 
result of the operation. See Vector’s RAID - RAPID 
INTERACTIVE DEBUGGER, REFERENCE MANUAL for more 
detailed information. 

Allows access at the console to the contents of a disk file in 
hexadecimal form, listing sixteen bytes at a time, along with a 
relative offset address. 

Creates the list device files (.LDn) for VECTOR 4 CP/M by 
converting a hex file to a ’.LD1’ or ’.LD2’ file for use by the 
system. 


Tost Commands 

DISKTEST Checks and determines whether a system failure is 'due to a 
hardware or software problem; also used for obtaining required 
patterns for alignment of the floppy drive. 

MEMTEST Checks common memory and each bank of memory listing bank 
addresses and status. 


RECLAIM Attempts to recover a file with a bad sector and remaps the 
disk to prevent other programs from using the bad sector. 

CRC . Runs a Cyclic Redundancy Check (CRC) on a specified program 

and produces a CRC value, which can be checked against the 
System disk listing for program comparisons. 
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CPUTEST Reads and writes address 1AAH with AAH. 


SCNTEST Used for adjusting focus of CRT. 


PORTEST Checks special port functions. 

KYBDTEST Tests all physical keyboard codes and prints them. 

PRINTEST Checks functioning of printers. 

Transient commands are specified in the same manner as resident commands; 
additional commands can be easily defined by the user. As an added convenience, 
the transient command can be preceded by a drive name which causes the transient 
to be loaded from the specified drive into the TPA for execution. Thus, the 
command ’A>B:STAT’ causes CP/M to temporarily ’log* into Drive B for the source 
of the STAT transient, and then return to the original logged disk for subsequent 
processing. 


3.2 UTILITY COMMANDS 


3.2.1 GEN SYS Command 

I 

The GENSYS transient command allows generation of an VECTOR 4 CP/M operating 
system onto an initialized double-sided diskette or an initialized hard disk. The 
program will automatically determine the type of system that exists and will prompt 
for one of the two possible systems to generate. GENSYS will then prompt for 
information pertaining to the possible available options for the specific type of' 
system; : these options can only be altered by the program. If it can’t determine the 
destination disk from the information provided, it will then prompt for the 
destination drive. The program places a copy of the VECTOR 4 CP/M onto the 
system tracks of the destination drive and will then prompt the user whether to 
copy the following files: 

VECTOR.CPM Operating System file 


VECTOR.LD1 

VECTORJLD2 

VECTOR.CMD 


List Device 1 (Serial driver) file 
» List Device 2 (Parallel driver) file 
Auto-Boot Command file 
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GENSYS.COM GENSYS program 

When running GENSYS from a hard disk system, and the destination drive is also a 
hard disk, the VECTOR files will not be copied. 


A* FLOPPY DISK ONLY SYSTEM 

VECTOR 4 CP/M SYSTEM GENERATION UTILITY 
VERSION 1.0 

SELECT THE DESTINATION DRIVE [A], [B], [C\ [D]s 

Enter ’A’, ’B’, T C% or *D' as the final destination of the CP/M operating 
system currently being generated; the drives shown in the prompt will be 
the currently available double-sided floppy drives within the user's 
system; no single-sided drives will display because the system may only be 
written to a doubled-sided diskette. 

INSERT DESTINATION DISKETTE AND PRESS THE [RETURN] KEY WHEN 
READY: 

Insert the diskette that will be the destination of the CP/M system and 
enter a [RETURN] when ready. 

ERROR - "VECTOR.CPM" FILE NOT FOUND ON THE SOURCE DRIVE 

This error message will display if no VECTOR.CPM file is found on the 
source disk; the result being no operating system being generated. 

DO YOU WANT THE VECTOR SYSTEM AND LIST DEVICE FILES COPIED? 
[Y] OR [N]s 

If the destination diskette is new or has never had a system placed on it, 
it will not have these files. Enter ? Y’ to copy the Vector System and 
List Device files onto the destination diskette; otherwise, enter ’N’. 
Entering a ’N T response will still copy the operating system onto the 
destination diskette even though it will not copy the List Device files. 
All of these files, when copied, will remain in System status and, 
therefore, will not appear in the directory. 

INSERT SOURCE DISKETTE AND PRESS THE [RETURN] KEY WHEN READY: 
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This prompt and the following will display only if the Vector System and 
List Device files are to be copied. Insert the diskette that has CP/M on 
it and enter a [RETURN] when ready. 

INSERT DESTINATION DISKETTE AND PRESS THE [RETURN] KEY WHEN 
READY: 

Again, insert the destination diskette and enter a [RETURN] when ready. 

VBCTCR.OM FILE COPIED TO DESTINATION DRIVE 
VBCICR.LD1 FILE COPIED TO DESTINATION DRIVE 
VBCICR.LD2 FILE COPIED TO DESTINATION DRIVE 
VECKK.CMD FILE COPIED TO DESTINATION DRIVE 
GENSY5.COM FIIZ COPIED TO DESTINATION DRIVE 

This message will display after the files have been copied to the 
destination disk successfully. The VECTOR.CMD file will only be found 
and copied if the user has created an auto command, using the 
CONFIG A option. 

SYSTEM GENERATION COMPLETED 


8* FLOPPY ANP /Q B HARD DISK SYSTEMS 

VECTOR 4 CP/M SYSTEM GENERATION UTILITY 
VERSION 1.0 

[1] GENERATE FLOPPY ONLY SYSTEM 

[2] GENERATE 5 MBYTE WINCHESTER SYSTEM 

SELECT ONE OF THE ABOVE: 

This prompt will display if the system has either a Floppy or a 5 Mbyte 

hard disk system. If you want to generate a CP/M operating system on a 

floppy, enter *1’ and follow the prompts for the Floppy Only System as 

shown above in A.; if you want to generate an operating system on a 

hard disk, enter ’2', for a 5 Mbyte system. 

* 

SELECT THE NUMBER OF LOGICAL SURFACES [1] OR [2]: 

This message will display for a 5 Mbyte system only; enter ’l* if the hard 
disk is to be just one logical drive (Drive A) or *2* if it is to be two 
logical drives (Drives A and B). 
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[1] 256 ENTRIES 

[2] 512 ENTRIES 

[3] 768 ENTRIES 

[4] 1024 ENTRIES 

SELECT THE DIRECTORY SIZE FROM ABOVE: 

If a small number of large files are expected to be used, select a smaller 
directory size. With a smaller directory, the system will run marginally 
faster because the program will have to read fewer entries. If a large 
number of smaller files are expected to be used, select a larger directory 
size. 

CAUTION: When installing an operating system on more than one drive 

(within a hard disk system), the same directory size for all drives must 
be selected in order to avoid conflicts. 

SYSTEM GENERATION COMPLETED 

Upon completion of a successful system generation, the new disk or 
diskette will contain the operating system; 'a system reboot of the surface 
having just received the new operating system is automatic. If the 
surface is blank or has just been formatted for some reason, only the 
operating system will now reside on it; however, only the resident 
commands are available. A freshly formatted diskette appears to CP/M 
as a diskette with an empty directory; therefore, the user must copy the 
appropriate COM files from an existing CP/M diskette to the newly 
constructed diskette using the PIP command. 

The user can copy all files from an existing diskette to another diskette 
or to a hard disk by entering the PIP command 

PIP B!=A:*.*[V] 

which copies all files from Drive A to Drive B and verifies that each file has been 
copied correctly. The name of each file will be displayed at the terminal as the 
copy operation proceeds. Drives A and B can be switched in the PIP command line 
if the user is copying files onto the hard disk with the floppy (B or C)!as the 
source; e.g.: 

PIP Ar=B:*.*[V3 
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It should be noted that a GENSYS does not destroy the files which already exist on 
a diskette; it results only in construction of a new operating system. Further, a 
system must be put on any floppy that will be used in booting the system. 

3.2.2 CON FTG Command 

The CONFIG command allows the user to create a personalized system by setting 
up various options within VECTOR 4 CP/M for the printer, to enable automatic 
page feed, to create an ’auto-boot’ command (either temporarily, or to be saved on 
disk), and to set drive configurations, printer driver selection, and boot options. 
All options have initially been set and will, display the default settings within 
parens when running any of the CONFIG options; however, these may be changed at 
any time according to the user’s needs. Prompts for the different options can be 
changed by entering a letter, number, or command line, as in the case of 
’auto-boot; to keep the present values, which will be displayed on screen, simply 
enter a [RETURN]. The options (F, D, S, P, A, O, C, and B) can be entered 
individually or in groups of options, as needed. All CONFIG commands will exit via 
a warm boot except CONFIG F, which exits via a cold boot. The command line 
should be in the following format: - 

CONFIG <option(s)> 

e.g., CONFIG FDSPAOCB (no space or comma between options) or any combination 
of these options. 

CO NFIG 

When ’CONFIG’ is entered without any options added, it will default to the ’P’ 
(printer) option and attach the list device temporarily. Faster selection of the 
print options can be achieved by specifying that option within the command 
line, e.g.: • 

CONFIG 1 

CONFIG will respond with one of the following messages: 

OPTION SELECTED 
or 

PRINTER IS BUSY 
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This feature will allow easier use of the configuration program for printer 
selection, and the ability to select a printer with either a cold or warm 
auto-boot command by using ’CONFIG x’ as the auto-boot command, where ’x’ 
is equivalent to one of the following: 

0 = Discard Printout 

1 = List Device 1 

2 = List Device 2 

3 = Route Printer Output to System Console 


CQ NFIG.E 

This option will allow the user to select the configuration of the floppy disk 
drives. Each drive may be individually configured to either single or double 
sided. The current status of each drive is listed along with the prompt for 
that drive. 

FLOPPY DISK CONFIGURATION (SINGLE/DOUBLE) 

SET DRIVE ds TO [S] SINGLE OR [D] DOUBLE SIDED - (D): 

SET DRIVE ds TO [S] SINGLE OR [D] DOUBLE SIDED - (D)s 

SET DRIVE ds TO [S] SINGLE OR [D] DOUBLE SIDED - (D)s 

The current assignment will display for each drive. The floppy disk 

configurations are initially set as double sided. To change the 
configuration to single sided, enter ’S’ when prompted for that drive; 
otherwise, enter a [RETURN] for each prompt to keep the present drive 
configuration. 

MAKE SELECTION PERMANENT [YHN]? 

Enter ’Y’ to make the configuration changes permanent; ^otherwise, enter 
’N’ for a temporary (or in-memory) change only. CONFIG F will exit via 
a cold boot. 

.CONFI G D 

This option will allow the user to alter the disk configuration options. 
However, its use and consequences should be fully understood. As you are 
prompted for each option, its current status will be displayed with the prompt. 
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DISK ACCESS OPTIONS FOR DRIVE d: - ENTER [E] ENABLE OR 
[D] DISABLE 

READ BEFORE WRITE (ENABLED): 

READ AFTER WRITE (ENABLED): 

WRITE PROTECT DETECT (ENABLED): 

READ ONLY (DISABLED): 

The ’READ BEFORE WRITE’ and ’READ AFTER WRITE’ should be 
enabled to ensure error correction; however, both can be disabled to 
allow a slightly faster system. When disabled, however, errors may not 
be detected. 

The ’WRITE PROTECT DETECT’ should be kept enabled if the 
write-protect tabs are being used. 

The ’READ ONLY’ option will allow a software write-protect feature on 
selected disk drives. 

MAKE SELECTION PERMANENT [YHN]? 

Enter ’Y’ to make the changes permanent; otherwise, enter ’N’ for a 
temporary (or in-memory) change only. 


C ON FI G. S 

This option will allow the user to alter the system options. It should normally 
not be necessary to execute this program as the options have been set for 
optimum system performance. 

DESPOOL TAB EXPANSION (DISABLED): 

Enter ’E’ to enable the despool tab expansion at intervals of eight 
characters; : enter ’D* to disable tab expansion. This option is initially set 
for ’DISABLED’. 

DESPOOL CHARACTERS PER TIME SLICE (3): 

Enter the number of characters (1 to 9) per time slice, as needed; the 
normal default is ’3’. This is the number of characters that are sent out 
by the despooler during its execution interval. 

CCP TO BDOS CROSS BANK CALLS (DISABLED): 

BDOS TO BIOS CROSS BANK CALLS (DISABLED): 
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These crossbank call options should be left disabled except if a program 
either intercepts CCP BDOS calls or modifies the BIOS Jump Table. 

RETURN CP/M VERSION NUMBER [2.5] OR [3.0] - (2.5): 

This option will allow the user to alter the returned version number of 
CP/M through BDOS function 12, causing the record and file lock 
facilities to be disabled or enabled. Entering '2.5' will disable the 
facilities allowing most 2.2 .‘version software to work (set initially to 2.5), 
while entering *3.0' will enable the record and file lock facilities. 

SELECTION PERMANENT [YHN]? 

Enter *Y’ to make the changes permanent; otherwise, enter *N’ for a 
temporary (or in-memory) change only. 


■ C QH H G E 

This option will allow the user to specify the destination of the printed list 
output stream; the system supports two printers on-line. The system maintains 
two different physical printer drivers; the print output stream may be directed 
to either driver, the console output (the video screen), or simply discarded 
(one may want to discard printout when no printer is connected to the system 
or in cases where software testing is being performed).' Generation of custom 
printer drivers is easily accomplished. 

[0] DISCARD PRINTOUT 

This option willisimply discard the printout entirely. 

[1] LIST DEVICE 1 

See [2] below. 

[2] LIST DEVICE 2 

The two list device options will send the printout to one of two printers; 
the current assignments will be displayed for the two list devices. In the 
event that the despooler is using one of the two list devices, it will 
display a ’busy* message, ignoring any user ’select* function. Once 
selected, the device will remain assigned until the user selects another 
device or the system is turned off. 
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Printer driver protocols are present in the system for printers which use 
the following protocols: 

- "Qume Type” parallel protocol (also "NEC Type" parallel protocol) 

- "Centronics Type" parallel protocol. 

- Standard Serial protocol. 

- XON/XOFF Serial protocol. 

- ETX/ACK Serial protocol. 

These protocols are described in the VECTOR 4 - TECHNICAL 
INFORMATION hardware manual. Also refer to Section 3.3.9 and Exhibit 
3-1 of this manual. 

The user can choose any one of the printer drivers during the ’CONFIG 
P’ procedure. 

[3] ROUTE PRINTER OUTPUT TO SYSTEM CONSOLE 
This option will send the printout to the terminal. 


C ONTIG A 

This option will allow the user to set and clear ’auto-boot’ commands. An 
auto-boot command is a CCP command that is executed automatically when 
CP/M is booted. The user has the choice of making the command execute 
either on a cold boot, a warm boot, or both; this will cause the system to 
boot directly into a given program bypassing the CP/M executive. You can 
only have one auto command per diskette or drive (the one from which the 
system is booted). This auto command is the one that is executed 
automatically when you boot CP/M from that diskette. 

[0] CLEAR AUTO COMMAND 

[1] AUTO COMMAND ON COLD BOOT 

[2] AUTO COMMAND ON WARM BOOT 

[3] AUTO COMMAND ON COLD AND WARM BOOT 

CURRENTLY - 0 *** NO COMMAND ASSIGNED *** 

ENTER DESIRED SELECTION: 

Enter ’0’ to clear any auto command already in effect; enter ’1’, ’2’, or 
’3’ to enable an auto command, depending whether the command should 
activate on a cold boot, a warm boot, or both. 
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NOTE: It should be remembered that using the auto command on both 

cold and warm boot will lock the user into that particular program. 

ENTER AUTO COMMAND STRING: 

Enter the filename of the program and any necessary parameters that 
CP/M should boot into; e.g., ’MEMORITE’ , ’EPL’, ’DIR’, 
’MB ASIC 5 MAILMEN U.B AS /S:512’, etc. 

MAKE SELECTION PERMANENT [YHN]? 

Enter ’Y’ to make the selected auto command permanent; otherwise, enter 
’N’ for a temporary change only. 

PRESS [RETURN] TO CONFIRM SELECTIONS OR [ESC] TO ABORT— 

Enter a [RETURN] to confirm the chosen auto command option or [ESC] 
to abort the program and return to CP/M. 

CQN2XG..Q 

This option will allow the user to adjust the variables of a selected list 
device; these variables include the number of physical and printed lines per 
page, the number of lines skipped at the top of each page, and an auto-paging 
feature. The prompts, along with the current values in parens, consist of the 
foEowing: • 

TOTAL NUMBER OF PHYSICAL LINES PER PAGE (55): 

TOTAL NUMBER OF PRINTED LINES PER PAGE (50): 

NUMBER OF LINES TO SKIP AT THE TOP OF EACH PAGE (5): 
[E]NABLE OR [DISABLE AUTO-PAGING (ENABLED): 

Enter the values to be changed for each variable. Note: Since the user can 

reassemble a printer driver to contain frequently used page settings, there is 
no need for the option of making these selections permanent. 

CONFIG C 

This option will allow the user to disable and enable certain character input; 
the control characters include the [CTRL K] and [CTRL P] that currently is 
intercepted by the BDOS and not printed. The user will have the option of 
making his selection permanent, if desired. 
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The prompt consists of the following: 

ENTER [E] TO ENABLE TRAPPING OR [D] TO DISABLE TRAPPING OF 
THE FOLLOWING CONTROL CHARACTERS (ENTER A [RETURN] FOR 
NO CHANGE): 

"P" (ENABLED): 

"K* (ENABLED): 

MAKE SELECTION PERMANENT [YHN]? 

Enter ’Y* to make the selected auto command permanent; otherwise, 
enter 'N f for a temporary change only. NOTE: This feature will be 
included in future releases of CP/M. 


C ONFIG, B 

This option will allow the user to adjust the baud rate of the selected list 
device; the adjustment made to the list device is not permanent. The prompt 
consists of the following: 

SELECT THE BAUD RATE FROM THE FOLLOWING: 

[110] [ISO] [300] [600] [1200] [2400] [4800] [9600] 


3*2*2 SQRTDIR Command 

The SORTDIR command will read the directory from a specified disk, sort it in 
alphabetical order, and write the newly sorted directory back to the disk; SORTDIR 
will also automatically erase any files of ’0K’ in length from the directory. The 
command line consists of the following format: 

SORTDIR <drive:> 


2*2*4 EDTR Command 

The EDIR command will read the directory from a specified disk, sort it in 
alphabetical order, and display the newly sorted directory on the terminal. EDIR 
has several options included for further flexibility which consist of the following: 

? will list all the available options; does not require a filename in the 
command line. 

S will list the file size of each file on the specified disk. 
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A will list the file attributes (R/O, R/W, SYS, etc.) of each file on the 
specified disk, including all system files not normally displayed. 

N will list the directory unsorted; the EDIR function will normally sort the 
directory. 

Un will list the directory from a specified user area (n = user number, 0-15), 
or from all user areas (n = *). 

EDIR will accept either an afn or ufn, and when finished displaying the directory, 
will display the remaining disk space. The command line consists of the following 
format: 

EDIR <drive^Kfilename> <option> 

3J2.5 ERAX Command 

The ERAX command will erase files from the currently logged disk allowing the 
user access to options not available with the ERA command. The ERAX command 
options consist of the following: 

? will list all the available options; does not require a filename within the 
command line. 

S will erase all files including system files. 

Un will erase all files in a specified user area (n = user number, 0-15), or 
from all user areas (n = *). 

Q will erase all files within a disk after an individual file query prompts 
the user whether to delete that particular file or not. This option will 
query with a ’(Y-N)?' prompt for all files except Read/Only; if a R/O 
file is encountered during the Query, a message to that effect will 
display on screen and the next non-R/O file will display along with the 
Query prompt. 

t?;,y dk v . r //' nA - 
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The ERAX command line consists of the following format: 

ERAX <drive:Xfilename> <[option]> 
and will return the following Query prompt line: 

< drived [Un] <filename> (Y-N)? 

If this file is to be deleted, enter 'Y'; if not, enter 'N' and ERAX will proceed to 
the next file. 


3.2.6 STAT Command 

The STAT command provides general statistical information about file storage and 
device assignment. It is initiated by entering one of the following forms: 

STAT 

STAT <conunand line> 

Special forms of the 'command line' allow the current device assignment to be 
examined and altered as well. The various command lines which can be specified 
are shown below with an explanation of each form. 

STAT 

If the user types an empty command line, the STAT command calculates the 
storage remaining on all active drives and prints one of the two following 
messages: 

d: R/W, Space: nnnk 
or 

d: R/O, Space: nnnk 

where 'd* = the active drive, *R/W' indicates the drive may be read or written 
to, 'R/O* indicates* the drive is read only (a drive becomes R/O by explicitly 
setting it to be read only, as explained later, or by inadvertently changing 
diskettes without performing a warm boot) and *nnn' indicates the space 
remaining on the diskette in Drive 'd' given in kilobytes. 
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STAT d: 

If a drive name is given, the drive is selected before the storage is computed. 
Thus, the command ’STAT B: * could be entered while logged into Drive A, 
resulting in the message: 

’BYTES REMAINING ON B: nnnk' 

The command line can also specify a set of files to be scanned by STAT. The 
files which satisfy the afn are listed in alphabetical order, with storage 
requirements for each file under the following heading: 

EBCS BYTS EX DsFIIflftM E.TSP 
rrr bbbk ee dsffffffff .ttt 

where ’rrr’ is the number of 128-byte records allocated to the file, ’bbb’ is 
the number of kilobytes allocated to the file (bbb=rrr x 128/1024), ’ee’ is the 
number of 16k extents (ee=bbb/16), ’d’ is the drive name containing the fEe (A 
- Z), ’ffffffff’ is the fEename containing a maximum of eight characters, and 
’ttt’ is the extension type containing a maximum of three characters. After 
listing the individual fEes, the storage usage is summarized. 

The drive name can be given ahead of the afn, as shown below; in this case, 
the specified drive is selected first and the specified afn form is then 
executed. 

STAT d:<afn> 

The STAT program has a number of additional functions which aUow disk parameter 
display, user number display, and fEe indicator manipulation. The command ’STAT 
VAL:’ produces a summary of the available status commands, resulting in the 
foEowing output: 

Temp R/O Disk - d:R/0 

Set Indicator - d:fflename.ext $R/0 $R/W $SYS $D£R 

Disk Status - DSK:d:DSK 

User Status - USRs 

IObyte Assign - < possible assignments> 

which gives an instant summary of the possible STAT commands. 
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The command form 'STAT d:filename.ext $S’, where 'd:' is an optional drive name 
and 'filename.ext' is an unambiguous filename, produces the output display format: 


Size 

Rees 

Bytes 

Ext 

Acc 

48 

48 

6K 

1 

R/O A:GftM.CCM 

55 

55 

12K 

1 

R/O A:PIP.OuM 

65536 

128 

2K 

2 

R/W A:X.DkT 


where the ’$S’ parameter causes the ’Size* field to be displayed (without the $S, 
the Size field is skipped, but the remaining fields are displayed). The Size field 
lists the virtual file size in records, while the ’Rees' field sums the number of 
virtual records in each extent. For files constructed sequentially, the Size and 
Rees fields are identical. 

The 'Bytes’ field lists the actual number of bytes allocated to the corresponding 
file. The minimum allocation unit is determined at the configuration time, and the 
number of bytes corresponds to the record count plus the remaining unused space in 
the last allocated block for sequential files. Random access files are given data 
areas only when written, so the Bytes field contains the only accurate allocation 
figure. In the case of random access, the Size field gives the logical end-of-file 
record position and the Rees field counts the logical records of each extent (each 
of these extents, however, may contain unallocated 'holes’ even though they are 
added into the record count). 

The 'Ext' field counts the number of logical 16K extents allocated to the file. The 
Ext count does not necessarily correspond to the number of directory entries given 
to the file, since there can be up to 128K bytes (8 logical extents) . directly 
addressed by a single directory entry, depending upon allocation size (in a special 
case, there are actually 256K bytes which can be directly addressed by a physical 
extent). 

The 'Acc' field gives the R/O or R/W access mode, which is changed using the 
commands shown below. Similarly, the parentheses shown around the PIP.COM 
filename indicate that it has the system indicator set, so that it will not be listed 
in DIR commands. The four command forms consist of the following and will set or 
reset various permanent file indicators: 

STAT d:filename.ext $R/0 

STAT thf Rename, ext $R/W 

STAT d:fRename.ext $SYS 

STAT <kfilename.ext $DER 
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The R/O indicator places the file (or set of files) in a read-only status until 
changed by a subsequent STAT command. The R/O status is recorded in the 
directory with the file so that it remains R/O through intervening cold boot 
operations. 

The R/W indicator places the file in a permanent read/write status. 

The SYS indicator removes the file from a normal directory display. 

The DIR indicator removes the SYS indicator from a file. 

The ’filename.ext’ may be ambiguous or unambiguous, but in either case, the files 

whose attributes are changed are listed at the terminal when the change occurs. 

The drive name denoted by ’d: T is optional. 

When a file is marked ’R/O', subsequent attempts to erase or write into the file 
result in a BDOS error message ’ERROR - d:FILE IS READ-ONLY’. The BDOS 
then waits for a console input before performing a subsequent warm boot (a 
[RETURN] is sufficient to continue). The command form ’STAT d:DSK:’ lists the 
drive characteristics of the disk named by ’d:’ which is in the range A 
The drive characteristics are listed in the format: 


d: Drive Characteristics 
62580: 128 Bjyte Record Capacity 
8160: Kilobyte Drive Capacity 
512: 32 Byte Directory Entries 
0: Checked Directory Entries 
512: Records/Extent 
64: Records/Block 
64: Sectors/Track 
4: Reserved Tracks 


where ’d:' is the selected drive, followed by the total record capacity (65536 is an 
8-megabyte drive), followed by the total capacity listed in kilobytes. The directory 
size is listed next, followed by the ’checked’ entries. The number of checked 
entries is usually one quarter the directory size for removable media, since this 
mechanism is used to detect changed media during CP/M operation without an 
intervening warm boot. . For fixed media, the number is usually zero, since the 
media is not changed without at least a cold or warm boot. The number of records 
per extent determines the addressing capacity of each directory entry (512 times 
128 bytes, or 64K in the example above). 

The number of records per block shows the basic allocation size (in the example, 64 
records/block times 128 bytes per record, or 8K bytes per block). 
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The listing is then followed by the number of physical sectors per track and the 
number of reserved tracks. The command form ’STAT DSK:’ produces a drive 
characteristics table for all currently active drives. 

The final STAT command form is ’STAT USR:’ which produces a list of the user 
numbers which have files on the currently addressed disk. The display format is: 

Active User: 0 
Active FQ.es: 0 13' 

where the first line lists the currently addressed user number, as set by the last 
CCP USER command, followed by a list of user numbers scanned from the current 
directory. In the above case, the active user, number is ’0’ (default at cold boot), 
with three user numbers which have active files on the current disk. The user can 
subsequently examine the directories of the other user numbers by logging-in with 
’USER 1’, ’USER 2’, etc. commands, foEowed by a DIR command at the CCP level. 


3.2.7 PIP Command 

PIP is the CP/M Peripheral Interchange Program which implements the basic media 
conversion operations necessary to load, print, punch, copy, and combine disk files. 
The PIP program is initiated by entering one of the foEowing forms: 

PIP 

PIP <command line> <parameters> 

In both cases, PIP is loaded into the TPA and executed. In the first example, PIP 
reads command lines directly from the console, prompted with the asterisk (*) 
character, until an empty command line is entered, i.e., a [RETURN] is entered 
without preceeding data. Each successive command line causes some media 
conversion to take place according to the rules shown below. The second example 
of the PIP command is equivalent to the first except that the single command line 
given with the PIP command is automatically executed, and PIP terminates 
immediately with no further prompting of the console for input command lines. The 
form of each command line consists of the foEowing: - 

D estination=5ourc e l,Source 2,~J3ource n 
* 

where ’Destination’ is the fEe or peripheral device to receive the data, and Source 
1 through n represents a series of one or more files or devices which are copied 
from left to right to the destination. 
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When multiple files are given in the command line, the individual files are assumed 
to contain ASCII characters, with an assumed CP/M end-of-file character 
([CTRL Z]) at the end of each file (see the ’O' parameter to override this 
assumption). Lower case ASCII alphabetics are internally translated to upper case 
to be consistent with CP/M file and device name conventions. Finally, the total 
command line length cannot exceed 255 characters ([CTRL E] can be used to force 
a physical carriage return for lines which exceed the console width). 

The destination and source elements can be ufn references to CP/M source files, 
with or without a preceeding disk drive name defining the particular drive where 
the file may be obtained or stored. When the drive name is not included, the 
currently logged disk is assumed; further, the destination file can also appear as 
one or more of the source files, in which case the source file is not altered until 
the entire concatenation is complete. If the destination file already exists, it is 
removed if the command line is properly formed (it is not removed if an error 
condition arises). The following command lines, with explanations, are valid as 
input to PIP: 


X=Y 


Copy to the file T X T from file 'Y', where X and Y are unambiguous 
filenames; Y remains unchanged. 


X=Y,Z 


Concatenate files f Y* and ’Z’ and copy to file ’X', with Y and Z 
unchanged. 

X«ASM= Y JV.SM,Z«ASM,FIN .ASM 

Create the file ’X.ASM' from the concatenation of the *Y’, *Z\ and ’FIN’ 
files with the extension of ’.ASM*. 


B:A.U=8:B.Y,A:C.W,D.X 


Concatenate file ’B.V’ from Drive B with 'C.W* from Drive A and T D.X’ 
from the logged disk and create the file r A.U’ on Drive B. 
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For more convenient use, PIP allows abbreviated commands for transferring files 
between disk drives consisting of the following: 

PIP Xr=<afn> 

PIP Xr=YKafn> 

PIP <ufn>=Y: 

PIP X:<ufn>=Y: 

The first form copies all files from the currently logged disk which satisfy the afn 
to the same filenames on Drive X (X=A...Z). The second form is equivalent to the 
first, where the source for the copy is Drive Y (Y=A...Z). The third form is 
equivalent to the command ’PIP <ufn>=Y:<ufn>’ .which copies the file given by the 
ufn from Drive Y to the file ufn on Drive X. The fourth form is 1 equivalent to the 
third, where the source disk is explicitly given by ’Y’. 

Note that the source and destination disks must be different in all of these cases. 
If an afn is specified, PIP lists each ufn which satisfies the afn as it is being 
copied. If a file exists by the same name as the destination file, it is removed 
upon successful completion of the copy, and replaced by the copied file. 

The following PIP commands give examples of valid disk-to-disk copy operations: 


B:=*.COM 


Copies all files which have the extension of ’.COM’ to Drive B from the 
current drive. 

A:=B:ZAP.* 

Copies all files which have the filename of ’ZAP’ to Drive A from 
Drive B. 

ZAPJVSM=B: 

Equivalent to ZAP.ASM=B:ZAP.ASM 
BtZOT.COM=A: 

Equivalent to *B:ZOT.COM=A:ZOT.COM 
Br=GAMMA-BAS 

Same as B:GAMMA.BAS=GAMMA.BAS 
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Br=A:GAMMA.BAS 

Same as B:GAMMA.BAS=A:GAMMA.BAS 

PIP also allows reference to physical and logical devices which are attached to the 
CP/M system, along with a number of specially named devices; the logical devices 
consist of: 

CON: (console) 

RDR: (reader) 

PUN: (punch) 

LST: (list) 

while the physical devices are: 

TTY: (console, reader, punch or list) 

CRT: (console, or list) 

PTR: (reader), UR1: (reader), UR2: (reader) 

PTP: (punch), UP1: (punch), UP2: (punch) 

LPT: (list), UL1: (list) 

Note that this assignment is used only to indicate that the RDR: and LST: devices 
are to be used for console I/O. 

The RDR:, LST:, and CON: devices are all defined within the BIOS portion of 
CP/M. The destination device must be capable of receiving data (e.g., data cannot 
be sent to the punch), and the source devices must be capable of generating data 
(e.g., tiie LST: ^device cannot be read). 

The additional device names which can be used in PIP commands are the following: 

NUL: Sends 40 ’nulls' (ASCII 0s) to the device (this can be issued at the 

end of punched output). 

EOF: Sends a CP/M end-of-file (ASCII [CTRL Z]) to the destination device 

(sent automatically at the end of all ASCII data transfers through 
PIP). 
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INP; Special PIP input source which can be ’patched* into the PIP 
program itself. 

The user can also specify one or more PIP parameters, enclosed in left and right 
brackets and separated by zero or more blanks. Each parameter affects the copy 
operation, and the enclosed list of parameters must immediately follow the affected 
file or device. Generally, each parameter can be followed by an optional decimal 
integer value (the S and Q parameters are exception). Following is a list of valid 
PIP parameters: 

B Block mode tranfer; !data is buffered by PIP until an ASCII X-off 
character ([CTRL S]) is received froip the source device. This allows 
transfer of data to a disk file from a continuous reading device, such as 
a cassette reader. Upon receipt of the X-off, PIP clears the disk 
buffers and returns for more input data. The amount of data which can 
be buffered is dependent upon the memory size of the host system (PIP 
will issue an error message if the buffers overflow). 

Dn Delete characters which extend past column ’n’ in the transfer of data to 
the destination from the character source. This parameter is used most 
often to truncate loing lines which are sent to a (narrow) printer or 
console device. 

E Echo all transfer operations to the console as they are being performed. 

F Filter form feeds from the file. All imbedded form feeds are remove4d. 

The P parameter can be used simultaneously to insert new form feeds. 

Gn Get file from user number ’n* (n = JJ - 15). 

H Hex; data transfer; ! all data is checked for proper Intel hex; file format. 

Nonessential characters between hex records are removed during the copy 
operation. The console will be prompted for corrective action in case 
errors occur. 

i; Ignore "idO" records in the transfer of Intel hex; format file (the II 
parameter automatically sets the H parameter). 

L Translate upper case alphabetics to lower case. 

N Add line numbers to each line transferred to the destination starting at 

one, and incrementing by 1. Leading zeros are suppressed, and the 

number is followed by a colon. If ’N2’ is specified, leading zeros are 
included and a tab is inserted following the nubmer. The tab is expanded 
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if 'T' is set. 


Pn Include page ejects at every 'n* lines (with an initial page eject). If 
n = 1 or is excluded altogether, page ejects occur every 60 lines. If the 
F parameter is used, form feed suppression takes place before the new 
page ejects are inserted. 

Qs z Quit copying from the source device or file when the string 's’ 
(terminated by [CTRL Z]) is encountered. 

R Read system files; files with the system attribute can be included in PIP 
tranfers using the R parameter; otherwise, system files are not 
recognized. The system file attributes are copied also. 

Ss z Start copying from he source device when the string 's' is encoutnered 
(terminated by [CTRL Z]). The S and Q parameters can be used to 
'abstract' a particular section of a file, such as subroutine. The start 
and quit strings are always included int he copy operation. 

Tta Expand tabs ([CTRL L] characters) to every 'nth' column during the 
transfer of characters to the destination from the source. 

U Translate lower case alphabetiqs to upper case during the copy operation. 

V Verify the data has been copied correctly by rereading after the write 

operation (the destination must be a disk file). 

W Copy all nonsystem files and overwrite any R-0 (read-only) files in the 
process; eliminates the 'delete' prompt when purposely overwriting an 
existing file. 

Z Zero the parity bit on input for each ASCII character. 


3AJ FORMAT Command 

The FORMAT command allows the user access to a general purpose disk formatter, 
written to run under all present versions of CP/M supported by the DualMode 
Controller Board. 
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There are two types, or options, of formatting available: The initial physical hard 
disk format (when there is no system or data on the disk), and the regular floppy 
and hard disk format. 

A* FORMAT P - Initial Physical Hard disk Format 

This command option will format a Winchester hard disk from a floppy disk. 
The following dialogue consists of the prompts and explanations when using the 
’P* option. 

A>FORMAT P 

The user enters this command line, format to run the physical hard disk 
FORMAT program. 

DISK FORMATTER VERSION 1.0 

SELECT [A] SURFACES 0,1 

[B] SURFACES 2,3 

[C] ALL SURFACES 

SELECT SURFACES FROM ABOVE: 

This prompt will only be displayed if your 5-inch Winchester is configured 
as a dual logical drive; Enter ’A’ to format surfaces 0 and 1 (Drive A), 
'B* to format surfaces 2 and 3 (Drive B), or *C’ to format all surfaces 
(Drives A and B. 

Otherwise the following prompt will be displayed. 

WARNING - PROCEDURE ERASES DATA. 

PRESS [RETURN] TO CONTINUE, [CTRL C] TO ABORT 

This warning message will informs the user that to continue will erase all 
data on the disk. If there is any information (data or programs) on the 
disk that the user does not want to lose, enter a [CTRL C] to abort the 
operation and save that information; otherwise, enter a [RETURN] to 
continue. 

FORMAT COMPLETE 

The selected physical surfaces have been successfully formatted; it is now 
possible to create a CP/M operating system and transfer any needed 
programs to the formatted disk. 
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2* FORMAT /options - Regular formatting with options 

This command, with options, will format single or double sided diskettes and, if 
necessary, selected areas of the Winchester hard disk, in case of 
non-correc table disk errors or other problems with the disk. The options 
available are: 

• R - for Repeat FORMAT function. 

• E - "E" provides error messages as to specific BIOS error codes. 

The following dialogue consists of the prompts and explanations of FORMAT 
without options: 

FORMAT 


The user enters this command line format, without options, to run the 
regular FORMAT program. After the title and version number display, 
the following prompt will appear (the selections vary depending on the 
system configuration). 


DRIVE: [A] 5 iffiSTE WINCHESTER - SURFACE 

[B] 5 MBJTE WINCHESTER - SERFAGE 

[C] 5 INCH SHOE-SIDED FLCPFY 

[D] 5 INCH EOCELE-SUED FLCPFY 

[E] 5 INCH DOGBLE-SIEED FLOPPY 


,1 

,3 


MAKE SELECTION FROM ABOVE: 


Enter the specific drive type to be formatted (usually this will be for 
formatting floppies). The only time the hard disk should be formatted is 
if the disk is damaged or is getting permanent disk errors. The drives 
shown above may be different depending on the configuration of the 
user’s system. 


IfLone. of. the hard disk surfaces is chosen, the following message will display: 

WARNING - PROCEDURE ERASES DATA. 

PRESS [RETURN] TO CONTINUE, [CTRL C] TO ABORT 

This warning message will display to inform the user that continuing will 
erase all data on the disk. 
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If there is any information (data or programs.) on the disk that the user 
does not want to lose, enter a [CTRL C] to abort the operation and save 
that information; otherwise, enter a [RETURN] to continue. 

FORMAT COMPLETE 


If one of the floppy drives is chosen, the following message will display: • 
INSERT DISKETTE AND 

PRESS [RETURN] TO BEGIN, [CTRL C] TO ABORT 

If there is any information (data or programs) on the disk that the user 
does not want to lose, enter a [CTRL C] to abort the operation and save 
that information; otherwise, enter a [RETURN] to begin formatting. 

FORMAT COMPLETE 

If the user wants to format several diskettes, without entering ’FORMAT’ each 
time, the Repeat (’R’) option can be used within the command line, that is: 

FORMAT R 

This command option will display the regular FORMAT prompts; however, 
instead of the program ending after the prompt ’FORMAT COMPLETE’, it will 
continue to prompt the user to make a drive selection to be formatted. 
FORMAT will continue prompting until the user enters a [CTRL C] to. 
terminate the program. 


IOlifi-iiSfiL .wants .ta. format disk e.tt as*, which will return specific types of 

permanent errors, the Error (’E’) option can be used within the command line, 
that is: 

FORMAT E 

This command option will, again, display the regular FORMAT prompts, except 
that when it is finished formatting, it will give a more specific error message, 
i.e.: 

* 

FORMATTING DISKETTE IN DRIVE C 

PERMANENT ERROR - FLOPPY WRITE PROTECT ERROR 
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3,2, 9 D ISKCOPY Co mm and 

The DISKCOPY command allows the user access to the floppy disk backup program 
designed to run under CP/M versions supporting the DualMode Controller Board. 
This program will perform backups for single- and double-sided diskettes, and, if a 
Winchester hard disk is available, will allow the hard disk to act as temporary 
storage for the source diskette, eliminating the swapping of source and destination 
diskettes. With this option, the source diskette is copied to the hard disk 
temporarily, if there is enough space available (storage on the hard disk will be 
reduced by a maximum of 600K), and finally copied to the backup diskette, without 
the need to swap source and destination diskettes over and over; also, multiple 
copies of one diskette can be made without further accessing the source diskette 
using the ’Repeat* option shown below. If the current drive is not a Winchester or 
if insufficient space exists on the drive, the backup must be made in the normal 
fashion. 

NOTE: This program does not allow backup from a drive configured as double-sided 
onto a drive configured as single-sided. Also, any attempt to copy from a 
single-sided diskette in a drive configured as double-sided may result in a 
•PERMANENT ERROR ON SOURCE’ message. 

There are two options available with DISKCOPY: the Repeat (R) copy option and 

the return Error (E) option. The command line format consists of the foEowing 
form, with or without options: 

DISKCOPY <option(s)> 

where either option, ’R’ and/or ’E’, may be used. The dialogue consists of the 
foEowing: 

A>DISKCQPY <option(s)> 

The user enters this command line format, with or without options, to run 
the floppy backup program. 
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DISKCOPY - VERSION 1.3 

DRIVE; [C] 5 INCH SINGLE-SIEED FLOPPY 

[D] 5 INCH DOCBLE-SIEED FLCPFY 

[E] 5 INCH DCJGBLE-SIESD FLOPPY 

SELECT SOCHCE ERIVE ERCM ABOVE: 

The drives shown above may vary with what is shown on screen, again 
because of the different configuration of the user's system. Enter 
the source drive name; i.e., the drive the source diskette is in 
(the one to be copied). 

SELECT EESTINATICN DRIVE ERCM ABOVE: 

Enter the destination drive, or where the information is to be 
copied. Remember, if the source is in a single-sided drive and the 
destination is in a double-sided drive, the destination diskette 
will be single-sided. However, the o pposite is not valid; a 
double-sided source drive will not write to a single-sided 
destination drive. A drive will read a diskette exactly as the 
drive was configured; i.e., a single-sided drive will read any 
diskette in it as single-sided, and a double-sided drive will try to 
read any diskette in it as double-sided. 

DO YCC wm TO T3SE THE 

WINCHESTER FGR TEMPORARY STORMS (Y/N) : 

This prcmpt will only display when a Winchester hard disk is in use; 
this option allows floppy disk duplication on a system with a 
Winchester drive and one floppy drive. Enter 'Y' to use the 
Winchester in a diskette to diskette backup; enter 'N' and the 
program will display the 'INSERT' diskette prompts. If insufficient 
free space exists on the currently logged drive (if the Winchester 
option is chosen), the program will respond with 

INSUFFICIENT FREE SPACE 

If the user wants to use the hard disk for copy purposes, log onto 
another drive of the hard disk which has more space available and 
rerun the program. 
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INSERT SCXBaE DISKETTE AND 

PRESS [RETURN] TO BEGIN, CR [CTRL C] TO ABORT: 

This prompt and the following prompt will display when the 
Winchester is not being used or if the Winchester does not have 
enough space to temporarily store the contents of the source 
diskette. DISKCOPY will erase or delete the original contents of 
the destination diskette during the copy operation. Insert the 
diskette, if not already inserted, and enter [RETURN] to begin the 
backup, or [CIRL C] to abort the program, if there is information on 
the destination diskette that should not be deleted. 

INSERT DESTINATICN DISKETTE AND 

PRESS [RETURN] TO BEGIN, CR [CTRL C] TO ABORT: 

This prompt and the previous prompt will alternate until the 
contents of the source diskette has been written to the destination 
diskette. 

DISBXP7 CCMPLEIE 


3-2.10 SEES Caimand 

The STORE command allows the user to 'backup' files from a specified user area 
on the hard disk which exceed the capacity of one floppy diskette. STORE has 
a conmand syntax which is virtually identical to the PIP program; the one 
difference is that it can only copy files which have names that are seven 
letters or fewer — eight letter filenames are ignored. 

The most important point to remember about STORE is that it erases all files 
in all user areas of the floppy which has been inserted into the drive for 
backup. The program checks to confirm that the output diskette is a floppy. 

When STOKE copies a file, it adds a '$' to the end of the filename. For this 
reason, a filename can only consist of up to seven characters instead of the 
usual eight. When the first diskette becomes full, the '$' at the end of the 
file being copied is changed to a zero (0) and the file is closed. Anew 
diskette is requested and a file is created with a '1* as the last character 
of the filename. If. the file fills the second diskette to capacity, the 
program will request a third diskette. A file with a *2' at the end of the 
filename will be created. This can continue until the entire file has been 
copied to as many floppies as needed. When the file has been completely 
written, the program will change the number at the end of the filename to a 
'$' and begin copying the next file, should there be another file. 
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Therefore, a ’$’ at the end of a filename signifies the last section of the 
file, and a number signifies that more of the file exists on another diskette. 
Note that if the filename in the command line ends with an asterisk (*), any 
eight-character filename fitting the specification will not be copied. For 
example, if you enter: 

STORE C:=HEST*.COM 

RESTORE.COM would be copied but RESTORES. CCM would not. If you are using 
STCRE to backup your files on a regular basis, it is imperative that all 
filenames consist of seven characters or less. It is also important that the 
user number each backup diskette so when a HESTCEE is attempted, the diskettes 
can be entered in proper sequence. 

To abort the program, enter a [GIRL C] and a [RETURN] when prompted for 
another backup diskette. This is not recommended because it leaves an 
incomplete backup; however, it can be useful should be became necessary for 
the user to quit processing prematurely. 


3.2L.11 B ESOBE Omaand 

The RESTORE command allows the user to transfer programs created by STCRE, 
from the floppy diskette back to the hard disk; only use RESTORE to copy files 
created by STORE. 

When entering a filename for RESTORE, it should be entered as it originally 
appeared in the directory of the hard disk; i.e., the filename should not have 
the ’$' or number at the end, unless the number was part of the original 
filename. 


Be sure to insert the diskettes in the correct order. Once RESTORE has begun 
copying files, it will ask the user for new diskettes as it needs them. The 
file which RESTORE searches for must be at the beginning of the diskette or 
'FILE NOT KXND’ will display and another diskette will be requested. 

Only after RESTORE ascertains that it has copied all files, will it display 
the message 




r NEXT DISK ID GCNTINOE OR [CTRL C] TO EXIT 


It may happen that, when using the ’wild card* to copy several files, RESTORE 
will find a filename ending with ’$’ and the file will be the last file on the 
diskette. There may be other files on the diskettes to be copied; however, 
RESTORE will have no way to know this. 
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The user will have to be alert to the situation and know to 
INSERT THE NEXT DISK TO (XNTINDE 
which will allow RESTORE to proceed. 

The only time RESTORE can be aborted, without resetting the systan, is when 
the program has finished copying a diskette. 

As in PIP, the *G* option is used to get files from other user areas. The 
user number following the ’G* mist be in the range, of 0 to 15 i 

If the hard disk is full or out of directory space, the program will abort. 
The problem of a full disk can sometimes be circumvented with the ’K’ (Kill) 
option. This option is available with RESTORE only. It may precede or follow 
the ’G’ option. It should be used cautiously because the ’K’ option causes 
the file it is copying to be deleted or ’killed* on the hard disk before it is 
copied. Normally, a file is created with the filename specified but with an 
extension of ’$$$’. Only after this file has been written to and closed will 
the original output file with the same name be killed if it exists. This 
temporary file is then renamed so that it has the proper extension. The ’K* 
option should only be used in the following cases: 

• The file you want to copy already exists on the hard disk 

• There is not enough room on the hard disk for the file 

• You cannot make enough room on the hard disk by deleting unwanted 
files 


3.3 




wwmsnmsE 


3 .3 . 1 3QG EEL Comnand 

The SCOPE (SC) conmand will allow the user to access SCCPE, Vector’s SCreen 
Oriented Program Editor, a program editor for Vector computers to create and 
edit any VECTOR GP /M ASCII file, either program text files or data files. See 
the VECTOR SCOPE REFERENCE MANUAL for more information on this editor. 
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3* 3 *2 ZSM Command 

The ZSM command will allow the user to convert Z-80 assembly language text 
(source code) into a sequence of machine language instructions (object code) which 
can then be loaded into the computer’s memory and executed. See the ZSM 
ASSEMBLER USER’S MANUAL for more information on this assembler. 

3*3*3 . LOAD Command 

The LOAD command will read the file (ufn), which is assumed to contain Intel ’hex' 
format machine code, and produce a memory image file which can be subsequently 
executed. The input file is assumed to have an extension of ’.HEX’ and, therefore, 
only the filename need be specified in the command. The LOAD command creates 
a file with an extension of ’.COM’ which marks it as containing machine executable 
code. The file is actually loaded into memory and executed when the user enters 
the filename immediately after the ’A>’ displayed by the CCP (this loaded program 
becomes a new command under the CCP). 

In general, the CCP reads the filename following the prompt and looks for a 
resident function name. If no function name is found, the CCP searches the system 
disk directory for the file with an extension of ’.COM’. If found, the machine code 
is loaded into the TPA and the program is executed. The user need only load a 
hex file once; it can be subsequently executed any number of times by simply 
typing the filename. In this way, the user can create new commands for use within 
the CCP (initialized disks contain the transient commands as COM files, which can 
be deleted at the user’s option). 

The operation can take place on an alternate drive if the filename is prefixed by a 
drive name; e.g., ’LOAD BiBETA’ brings the LOAD program into the TPA from the 
currently logged disk and operates in Drive B after execution of the program 
begins. It must be noted that the ’BETA. HEX’ file must contain valid Intel 
hexadecimal machine code records (as produced by the ZSM program) beginning at 
100H, the beginning of the TPA. Further, the addresses in the hex records must be 
in ascending order, gaps in unfilled memory regions are filled with zeros by the 
LOAD command as the hex records are read. Therefore, LOAD must be used only 
for creating CP/M-standard ’.COM’ files which operate in the TPA. Programs which 
occupy regions of memory other than the TPA can sometimes be loaded under DDT. 
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3.3.4 SUBMIT Command 

The SUBMIT command will allow CP/M commands to be batched together for 
automatic processing. The ufn given in the SUBMIT command must be a filename 
which exists on the currently logged disk, with an assumed extension of ’.SUB’. 
The SUB file contains CP/M prototype commands with possible parameter 
substitution. The actual parameters , , parm#l...parm#n’, are substituted into the 
prototype commands, and, if no errors occur, the file of substituted commands are 
processed sequentially by CP/M. 

The prototype command file is created using the SCOPE pregram, with interspersed 
’$* parameters of the form ’$1 $2 $3...$n* corresponding to the number of actual 
parameters which will be included when the file is submitted for execution. When 
the SUBMIT command is executed, the actual parameters T parm#l* are paired with 
the formal parameters , $l...$n’ in the prototype commands. If the number of formal 
and actual parameters does not correspond, the SUBMIT function is aborted with an 
error message at the terminal. 

The SUBMIT function creates a file of substituted commands with the name 
, $$$.SUB* on the logged disk. When the system reboots (at the termination of the 
SUBMIT), this command file is read by the CCP as a source of input rather than 
the terminal. If the SUBMIT function is performed on any disk other than Drive A, 
the commands are not processed until the disk is inserted into Drive A and the 
system reboots. Further, the user can abort command processing at any time by 
entering a [DEL] when the command is read and echoed. In this case, the $$$.SUB 
file is removed, and the subsequent commands come from the terminal. Command 
processing is also aborted if the CCP detects an error in any of the commands. 

In order to introduce dollar signs into a SUBMIT file, the user may enter a ’$$' 
which reduces to a single ’$’ within the command file. Further, an up arrow may 
precede an alphabetic character ’x’, which produces a single [CTRL X] character 
within the file. The last command in a SUB file can initiate another SUB file, thus 
allowing chained . batch commands. 
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For example, the file ’ASMBL.SUB’ exists on disk and contains the prototype 
commands: 

ZSM $1 
DIR $1.* 

ERA *.BAK 
PIP $2:=$1J J RN 
ERA $1.PRN 

and the command ’SUBMIT ASMBL X PRN’ is entered by the user. The SUBMIT 
program reads the ASMBL.SUB file, substituting ’X’ for all occurrences of ’$1’ and 
’PRN’ for all occurrences of ’$2’, resulting in a ’$$$.SUB’ file containing the 
following commands which are executed in sequence by the CCP: 

ZSM X 
DIR X.* 

ERA *.BAK 
PIP PRNr=XJ?RN 
ERA XJPRN 

The SUBMIT function can access a SUB file which is on an alternative drive by 
preceding the filename by a drive name. Submitted files are only acted upon, 
however, when they appear on Drive A. Thus, it is possible to create a submitted 
file on Drive B which is executed at a later time when it is inserted in Drive A. 

In certain cases, STAT will show user areas that are between 16 and 31, and the 
data in these areas cannot be accessed. This is the result of previously running 
SUBMIT and interrupting or aborting it in an unusual manner. In order that other 
users can execute a SUBMIT file, the system creates the $$$.SUB file in the 
default User area plus 16. If the SUBMIT aborts in an unusual manner this will 
reflect when using STAT. If you want to take the data off the disk and, 
therefore, the directory, execute the SUBMIT again and exit in a ’normal’ manner. 


3,3.5 -XSUB Command 

The XSUB utility program will extend the power of the SUBMIT facility to include 
line input to programs as well as the console command processor. The XSUB 
command is included as the first line of the SUBMIT file and, when executed, 
self -relocates directly below the CCP. 
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All subsequent SUBMIT command lines are processed by XSUB so that programs 
which read buffered terminal input (BDOS function 10) receive their input directly 
from the SUBMIT file. For example, the file ’SAVER.SUB’ could contain the 
following SUBMIT lines: 

XSUB 

DDT 

I$1.HEX 

R 

GO 

SAVE 1 $2.COM 

with a subsequent SUBMIT command (SUBMIT SAVER X Y) which substitutes X for 
$1 and Y for $2 in the command stream. The XSUB program loads, followed by 
DDT which is sent the command lines ’IX. HEX', 'R*, and ’GO’ and is finally 
returned to the CCP. The final command ’SAVE 1 Y.COM* is processed by the 
CCP. The XSUB program remains in memory and prints the message 
’(XSUB ACTIVE)’ on each warm boot operation to indicate its presence. Subsequent 
SUBMIT command streams do not require the XSUB, unless an intervening cold boot 
has occurred. Note that XSUB must be loaded after DESPOOL, if both are to run 
simultaneously. 


3.3.6 DDT Command 

The DDT command will allow dynamic interactive testing and debugging of programs 
generated in the CP/M environment. See the CP/M DYNAMIC DEBUGGING TOOL 
(DDT) USER’S GUIDE for more information on this debugging program. 


•UL2 R A ID-C o m m and 

The RAID command will allow the user to implement Vector’s Rapid Interactive 
Debugger program. RAID simulates a program step by step by taking each 
instruction of the program, executing it and displaying the result of the operation, 
a valuable tool for assembly language software development. See the 
RAID - RAPID INTERACTIVE DEBUGGER, REFERENCE MANUAL for more 
information on this debugging program. 


.3,3,3 DUMP Command 

The DUMP command will display the contents of the disk file (ufn) at the terminal 
in hexadecimal form. 
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The file contents are listed sixteen bytes at a time, with the absolute byte address 
listed to the left of each line in hexadecimal. Long displays can be aborted by 
entering any key (except [CTRL S]) during the printout. 


3.3.9 GENTJST Command 

The GENLIST command will allow the user to create the list device files for 
VECTOR 4 CP/M. It will take any ’hex’ file and convert it to an ’.LD1’ or ’.LD2’ 
file for use by the system. To execute the program enter ’GENLIST <filename>’. 
GENLE5T will sign on and then process the file. Provided there are no errors, 
GENLIST will display the load address, the last address, and then sign off. The 
generated file may then be copied (using PIP) into the appropriate ’VECTOR. LDn’ 
file for use by the system. 

To write and load a printer driver program, the code should be assembled to 
execute at address 0100H for Driver 1 and 0500H for Driver 2 (see Exhibit 3-1). 
The code for Driver 1 cannot exceed IK, and the code for Driver 2 cannot exceed 
1.5 K. 

The code should be written in an 'in-line* fashion; i.e., do not use multiple ’ORG’ 
statements. This will generate an error when the GENLIST program is run. The 
following format must be adheared to for all printer drivers: 


Exhibit 3-1. PRINTER DRIVER TABLE 

LOCATION BYTE REM ARK S 

DVR + 00 TYPE1 The first byte contains the printer Class (C) and 

Type (T) codes. The printer class code is contained 
in the upper nybble (bits 4-7) while the printer type 
code is contained in the lower nybble (bits 0-3); e.g.: 

BIT 7 — > CCCCTTTT <— BIT 0 

The assigned printer class codes consist of the 
following: 

* 

0000 = Undefined 

0001 = Draft Printer (Lineprinters) 

0010 = Word Processing Printer (Letter Quality) 

0011 - 1111 = Undefined 
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DVR + 01 


The assigned printer type codes depend on the 
printer class and are assigned as follows: 


Typg_Codfi 

Class 1 

S13SS-& 

0000 

No Printer 

No Printer 

0001 

S.D.* 

P.W.P.** 

0010 

P.D.*** 

P.W.P. 

0011 

S.D. 

S.W.P.**** 

0100 



0101 

Undefined 

Undefined 

1111 

Custom 

Custom 


Serial Draft Printer 
** Parallel Word Processor Printer 
*** Parallel Draft Printer 
**** Serial Word Processor Printer 

TYPE2 The second byte contains the interface descriptor 
byte. It is composed of four separate fields: 
Hardware (H), Undefined (U), Protocol (P), and 
Interface (I); i.e •• 

BIT 7 — > HHH U PPP I <— BIT 0 

The upper three bits (HHH) contain the hardware 
environment code and have been assigned the 
following values: 

000 = Undefined 

001 = Not Applicable 

010 = Vector 4 SBC 

011 = Undefined 
100 = Undefined 

Bit 4 (U) is an undefined field. 

Bits 1 through 3 (PPP) contain the protocol code and 
have been assigned the following values: ; 

000 = Hardware Handshaking 

001 = ETX/ACK Protocol 

010 = X-ON/X-OFF Protocol 

011 - 111 = Undefined 
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Bit 0 (I) is the interface type bit. If this bit is set 
(1), the interface will be serial; if this bit is reset 
(0), the interface is parallel. 

DVR + 02 INIT This routine should take care of any printer 

initialization. 


DVR + 05 


DVR + 08 


DVR + 0B 


INSTAT This is the input character status; it should return 
*00’ if no character is ready or ’FF’ if ready. If no 
input is possible, this routine should always return 
*00’; a returned value should always be in the 
A register. 

INCHAR This is the input character from the printer which 
should return the character in the A register. If no 
input is possible, this routine should return a *00 r in 
the A register. 

OTCHAR This is the output character to the printer which is 
passed in the C register. 


DVR + 0E OTSTAT This is the character output status. This routine 

should return a *00* if the printer is not ready for 
output or an f FF’ if it is ready; return values should 
be in the A register. 

DVR + 11 FORMLN This is the total number of physical lines per page. 


DVR + 12 


AUTOPG This is the auto paging flag. This byte should be 
set to ’00H’. 


DVR + 13 FORMPR This is the total of the number of printed lines per 

page and the number of blank lines at the top of 
each page. 

DVR + 14 ' TOPMRG This is the number of blank lines at the top of each 

page. 

grialer-Xyps Bgfcsa 


There are two bytes, located at the front of all VECTOR CP/M printer driver 
modules (i.e*, all ’.LD1’ and \LD2* files), that provide information about the printer 
and its interface to the system. 
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The ’.LDn* files can be generated from an appropriate hex file by using the 
GENLIST program. Several drivers are included on the system disk and may be 
copied (using PIP) into the appropriate driver file (i.e., 
PIP VECTORJjD1=SERIAL.LD1). After a printer driver file has been copied to the 
VECTOR. LD1 or .LD2 file, it is necessary to reset and reboot the system in order 
to use the newly defined driver file. 

The source files for both the serial and parallel drivers are included as an example 
on how to generate a driver file. These may simply be altered, or a new file may 
be generated. Following is a list of the printer driver files included on the system 
disk: - 


VECTORXD1 

VECTORJ.D2 

Copy of SER4.LD1 
Copy of NV4.LD2 

SER4.LD1 

SER4/H.LD1 

SER4/XJL.D1 

PAR4JL.D1 

Serial Driver 

Serial Driver w/ ETX/ACK protocol 
Serial Driver w/ XON/XOFF protocol 
Parallel Driver w/ "Centronics Type" protocol 

NV4.LD2 

QV4.LD2 

Parallel Driver w/ "NEC Type" protocol 
Parallel Driver w/ "Qume Type" protocol 

SERIAInASM 

PARALL.ASM 

Source File for Serial Driver 
Source File for Parallel Driver 


3.4 TEST COMMANDS 
3A 1 DISKTEST Command 

See the DISKTEST USER’S MANUAL for a complete description of this 
command. 


.3*4,2 — MEMTEST Co mmand. 

See the VECTOR' 4 - TECHNICAL INFORMATION MANUAL for a complete 
description of this command. 
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3.4.3 CRC Command 

The CRC (Cyclic Redundancy Check) Command will allow the user to return 
the CRC value(s) of a specified file, or files, for a comparison check with the 
CRC listing for each program or file on the System disk. Each file on the 
disk produces a specific CRC, and, when the CRC program returns each file’s 
CRC value, these values may be checked against known values to determine if 
the file is bad or if the file or program is a non-usable or incompatible 
version. 

The CRC value is based on the polynomial «X*16+X*15+X*7+X*2+X*1+1\ The 
file parameters include normal CP/M wildcards and are in the same form as 
the DIR function. The CRC value will be calculated and displayed for each 
file matching the file parameters given. The CRC program interfaces with the 
user through the CCP, and the file specification parameters are passed by the 
normal CCP linkages. Following are examples of valid command lines to find 
the CRC values for specified file(s): 

CRC TEST.COM 
CRC Ar*.* 

CRC MBASIC?.* 

CRC B:*.COM 
CRC A:VECTOR.LD? 

Each file matching the file specifications will be listed (the output will not be 
paged) along with its CRC value in the following format: 

NAME CRC 
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For example, the command line 
CRC *.COM 

could result in the following display: ■ 


CRC VER 

1.0 


NAME 


£B£ 

d:PIP 

COM 

1847 

dbSTAT 

COM 

B31E 

d:SUBMIT 

COM 

154B 


where ’d:' = the currently logged drive. 


3«4»4„ CPUTEST Command 

See the VECTOR 4 - TECHNICAL INFORMATION MANUAL for a complete 
description of this command. 


3.4.5 SCNTEST Command 

See the VECTOR 4 - TECHNICAL INFORMATION MANUAL for a complete 
description of this command. 

3.4.5 PORTEST Command 

See the VECTOR 4 - TECHNICAL INFORMATION MANUAL for a complete 
description of this command. 

1AJ. KYBDTSST Command 

See the VECTOR 4 - TECHNICAL INFORMATION MANUAL for a complete 
description of this ’command. 
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3.4.8 PRINTEST Command 

See the VECTOR 4 - TECHNICAL INFORMATION MANUAL for a complete 
description of this command. 


3.4.9 RECLAIM Command 

A. HOW TO RECOVER A FILE USING RECLAIM 

In rare instances, an error message may inform you that a disk has a bad sector. 
This could occur because of surface damage or because data has been otherwise 
scrambled. The bad sector could prevent you from recalling or transferring a file. 
RECLAIM is a special purpose program, included on your system disk, to help you 
recover data from a bad sector. 

A bad sector refers to a damaged spot on the disk, either because of wear, 
mishandling, or because the disk has been subjected to a magnetic field or other 
condition which would cause the data to be inadvertently altered. When VECTOR 4 
CP/M encounters a bad sector, it will report the error condition with the general 
message: 

ERROR - d:DISK READ/WRITE 
where 'd 1 is the disk drive name where the error occurred. 

To recover from the error, you can enter either a [CTRL C], which will abort the 
program and return you to the operating system, or a [RETURN], which will tell 
the system to ignore the error and continue. However, the integrity of the disk 
might be destroyed if you ignore the error, and the bad sector may prevent you 
from reading or copying a file. RECLAIM is a program specifically designed for 
these situations, where a bad sector could cause you to lose data. 

RECLAIM can be used to test the entire disk or to read a single file. It can be 
used to recover data from the hard disk or from a floppy diskette. The program 
reads and validates each sector of the user area of the disk, or each sector of the 
particular file to be recovered. 

* 

RECLAIM can be used in the 'Auto* or 'Edit* modes or together. The Auto mode 
will try to remap the disk or diskette if it encounters any errors. In the Edit 
mode, sectors with errors will be displayed on the screen and the operator may edit 
the sector, either in hex or ASCII. 


3-44 


P/N 7100-0003 


9-01-82 - Rev. A 



VECTOR 4 CP/M 
PROGRAMMERS GUIDE 


If an error is found in the file space, when running RECLAIM, the program will 
prevent other programs from using the bad sector. When using RECLAIM with a 
particular file, the program will also attempt to transfer the data in the bad sector 
to another part of the disk. 

If an error is found on the directory tracks, (the area of the disk where operating 
and storage information is kept), RECLAIM will abort. Information stored on these 
tracks is so critical to the operation of your disk, that once damaged, it cannot be 
recovered with RECLAIM. However, even if the directory tracks are damaged 
other data on the disk may be intact. It may help to transfer the data from the 
hard disk using the PIP or STORE programs. 

In the Edit mode, use the [CTRL F] function to switch from hex to ASCII. To 
move the cursor, use the cursor control and [RETURN] keys. To terminate the edit 
and allow the rewrite or transfer to continue, enter an [ESC]. Only sectors 
containing errors will be presented for editing. 

The Edit mode can only be used to test a particular file, i.e., it cannot be used if 
the entire disk is to be tested. 

Bi gQW. T Q USE RECLAIM 

If you are testing the hard disk, boot from the hard disk and run the RECLAIM 
program (RECLAIM may be loaded from the hard disk if it is present, or may be 
loaded from a floppy, if necessary). The drive which will be reclaimed is 
determined in the command line; for example, to test Drive A, enter 

RECLAIM A: You will see the banner and message: 

VECTOR GRAPHIC DISK RECLAIMER - VER. 1.1 

TESTING DIRECTORY SPACE 

and a block of numbers in hexadecimal, which will indicate the block being tested. 
The numbers will rapidly change as the program tests each sector on the disk. 

Should RECLAIM find an error in the directory space, it will inform the user with 
one of several error messages and end the program. < See the following section on 
RECLAIM error messages for further explanation and procedures. 
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If RECLAIM finds the directory space to be in order, it will display the message: 
TEST COMPLETE 

and continue by testing the file space, displaying the message: 

TESTING FILE SPACE 

The block numbers will be displayed and will change as the test proceeds. 

Should RECLAIM find an error in the file space, it will automatically remap the 
disk (if you are using the program in Auto mode) such that the space will not be 
used again. If you are trying to recover a particular file, RECLAIM will also 
attempt to rewrite the data in the bad sector to an unused part of the disk. 
Having tested all of the disk space, RECLAIM will display the message: 

TEST COMPLETE 

and will return control to the operating system. 

If you are testing the hard disk and have configured it as more than one logical 
drive, run RECLAIM again, to test the other drive(s). The format for the command 
line should be: 

RECLAIM ds<$A> 

where ’d’ represents the drive to be tested and '$A T denotes the Auto mode option. 
When testing the disk or diskette, only the Auto mode can be used as an option. 

To use the Edit mode of RECLAIM, enter 

RECLAIM d:<fllename.ext> $E 

where ’d* is the drive to be tested and ’filename.ext’ is the specified file to be 
edited. Note that the *$E’ option will only work on a single file at any one time, 
and never for an entire disk or diskette. 
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The follwing Edit Mode functions available will display on screen and can be used 
during the edit cycle: 

EDfT. M OPE. FUNCTIONS 

— EDIT FOCTICNS — 

USE ARROW KEYS TO POSITION CORSCR 
[CTRL B] - BCME CORSCR 
[CffiL F] - TOGGLE HEX/ASCII 
[REITSN] - NEXT LINE 
[ESC] - END EDIT 


The Edit mode and the Auto mode can be run at the same time by entering: 
RECLAIM d:<fflename.ext> $AE 
substituting the letter of the logical drive and the filename. 

PRESS [RETURN] TO REWRITE OR [ESC] TO RECLAIM 
C« — READING _ RECLAIM ERROR MESSAGES 

When the RECLAIM program encounters an error, it will inform the operator with 
one of several messages. Write the message on a piece of paper because it will 
help to troubleshoot ’fatal’ errors; that is, errors which the RECLAIM program 
itself cannot resolve. 


QEESAT.QIL SIGN-QN ERROR . MESSAGES;. 

ILLEGAL FILE NAME 
FILE NOT FOUND 

» 

The filename has been improperly entered or the file does not exist. 
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ILLEGAL DRIVE 
DRIVE NOT READY 

The drive to be accessed does not exist in the System’s logical drive 
configuration or no diskette has been mounted in the drive. 

FILE IS READ ONLY 
WRITE PROTECTED 

The diskette has a write-protect tab or the file is protected within 
VECTOR 4 CP/M. 


ERRORS THAT RECLAIM WILL RESOLVE 

CHECK SUM 
TRACK ADDRESS 
SECTOR ADDRESS 
HEAD ADDRESS 
ECC VERIFICATION 
DATA VERIFICATION 
UNRECOVERABLE ECC 
SYNC BYTE ERROR 

These messages refer to errors which occur because data related to 
addressing and verification has been damaged. If you are using the 
program in the Auto mode, RECLAIM will remap the disk to ensure that 
no other programs write data to the bad sector. If you are using the 
Auto mode and you are testing a particular file, RECLAIM will also try 
to transfer the data to another sector. After the operation, if you 
have reclaimed a floppy diskette, copy whatever files you can save and 
discard the worn diskette. 
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HARDWARE ERROR MESSAGES 

HOME ERROR 
CONTROLLER BUSY 
SEEK TIMEOUT 
LOSS OF SYNC 
WRITE FAULT 

IMPROPER CONTROLLER JUMPER 
SPASM ERROR 

These messages infer that a hardware problem prevents correct operation 
of the disk drive controller. Call your Vector Graphic Dealer for 
assistance. 


DIRECTORY ERROR MESSAGES 

DIRECTORY I/O ERROR 

FATAL ERROR IN DISK DIRECTORY 

These messages are displayed because the error occurred in the directory 
space of die disk; in which case the program will abort. When a bad 
sector error occurs in the directory space, you must reinitialize the disk. 
First, backup whatever files you can access using PIP or STORE. Then 
run the FORMAT program as described in this manual. After running 
FORMAT, put a new VECTOR 4 CP/M Operating System on the hard 
disk, following the procedures in this manual and write your files back to 
the hard disk using PIP or RESTORE. If you are testing a floppy 
diskette, you should copy as many of your files as possible to another 
disk and discard the worn diskette. 

CAN’T OPEN TEMP FILE 
CAN’T OPEN TRANSFER FILE 
CAN’T OPEN XXX.SYS 

These messages occur because the directory is full or because of a 
directory error. First, try to erase one or more files from the directory 
and run RECLAIM again. If the message repeats itself, it is probable 
that an error ‘occurred in the directory space, in which case the program 
will end. When this happens, backup the data you can access, using 
either PIP or STORE. Format the disk again and give it a new CP/M 
operating system. When testing a floppy diskette, copy as many files as 
you can access and discard the worn diskette. 
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VERSION ERROR MESSAGES 

NOT SUPPORTED UNDER THIS CP/M VERSION 

RECLAIM will not run with your system if you are using the wrong 
version of VECTOR 4 CP/M. 


O THER MESSAGES 

SECTOR REWRITE SUCCESSFUL 

The data was rewritten to the same sector successfully. 

SECTOR REWRITE UNSUCCESSFUL 

The data could not be recovered, and the bad sector was mapped so as 
not to be used again; if it is a file, data is moved to a different 
location on the disk. 

UNUSEABLE DISK SPACE 

When RECLAIM has finished, the program will inform you how much disk 
space was found to be unuseable. 

ABORTING— CAN’T OPEN 
TEMPORARY FILE 
ABORTING— FATAL DISK ERROR 
ABORTING— TEMP FILE ERROR 
TEST ABORTED 

These messages inform the operator that RECLAIM will end the program 
and return control to the VECTOR 4 CP/M operating system. 

D. HOW TO FIND A TRACK AND SECTOR FROM A GIVEN BLOCK NUMBER 

After running RECLAIM and backing up all of the data on the disk, you may want 
to use DISKTEST to step through the block which has the error. The following 
example will show you how to calculate a track and record number from a given 
block number. This equation will allow you to calculate the first sector of the 
block which contained the error. 
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Following is an example which works out the equation for a 5 1/ 4-inch hard disk drive, 
where the disk has a directory set for 256 entries and the given block number is 3. 

1. Run RECLAIM to find the Block Number of the sector with the error. 
Convert the Block Number from hexadecimal to decimal. 

2. Use the Parameter Table (Exhibit 3-2) to find the number of Records per 
Track, the number of Records per Sector, the number of Blocks for the 
Directory, the number of Reserved Tracks, and the number of Records per 
Block for your system. 

Records per Track: Records per Track: 64 

Records per Sector: Records per Sector: 2 

Blocks for Directory: Blocks for Directory: 2 

Reserved Tracks: Reserved Tracks: 4 , 

Records per Block: Records per Block: 32 

3. Work the following equation to find the Base Value. 

BASE VALUE = (RESERVED TRACKS)*( RECORDS PER TRACK) 

4(64) 

Base Value: Base Value: 256 

4. Work the following equation to find the Total Number of Records. 

TOTAL RECORDS = 

BASE VALUE + (BLOCK NUMBER * RECORDS PER BLOCK) 

256 + (3 x 32) 

Total Records: Total Records: 352 
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5. Work the following equation. The integer portion of the result gives you 1 
track number. The fractional portion of the result will be used to calculs 
the sector number. 

TRACK = _ T QTAIl.REC. PR PS— 

RECORDS PER TRACK 

352 = 5.5 
64 

Track:_i Track: 5 

6. Multiply the fractional portion, left from the division performed in step 6, 
the number of records per track, and divide by the number of records p 
sector. The result gives you the Sector. 

SECTOR = FRACTIONAL. RESULT RECORDS PE R TRA C K 

RECORDS PER SECTOR 


*5 * 64 
2 

Sector: Sector: 16 


Exhibit 3-2, R E C LAIM. P ARAMETER. T ABLE 


IF THE DRIVE 

RECORDS 

RECORDS 

BLOCKS 

RESERVED 

REC 

USES: 

PER 

PER 

FOR 

TRACKS 

PER 


TRACK 

SECTOR 

DIRECTORY 


BLO 

5 1/4" SINGLE- 

32 

2 

1 

2 

16 

SIDED FLOPPY 






5 1/4" DOUBLE- 

32 

2 

2 

4 

16 

SIDED FLOPPY 






5 1/4" HARD DISK 

'64 

2 

2 (256 entries) 

4 

32 


4 (512 entries) 
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SECTION IV - BDOS SYSTEM CALLS 


4.1 INTRODUCTION 

VECTOR 4 CP/M is an extremely powerful and flexible operating system that can 
support many different type of programs. It accomplishes this task by setting up a 
protocol, or method of communication, so that all programs, whether they are 
BASIC interpreters, word processors, or any other application program or utility, 
will be able to run effectively. 

VECTOR 4 CP/M is logically divided into four parts: the Basic Input/Output 
System (BIOS), the Basic Disk Operating System (BDOS), the Console Command 
Processor (CCP), and the Transient Program Area (TP A). 

The BIOS is a hardware-dependent module which defines the exact low level 
interface to a particular computer system which is necessary for peripheral device 
I/O. The BIOS and BDOS are logically combined into a single module with a 
common entry point, and referred to as the FDOS. The CCP is a distinct program 
which uses the FDOS to provide a hujnan-oriented interface to the information 
which is cataloged on the backup storage device. The TPA is an area of memory 
(i.e., the portion which is not used by the BDOS, BIOS, and CCP) where various 
nonresident operating system commands and user programs are executed. 

All standard CP/M versions, assume ’BOOT = 0000H’, which is the base of Random 
Access Memory (RAM). The machine code found at location BOOT performs a 
system ’warm start’ which loads and initializes the programs and variables necessary 
to return control to the CCP; therefore, transient programs need only jump to 
location BOOT to return control to CP/M at the command level. Further, the 
standard versions assume ’TBASE = 0100H'. The principal entry point to the FDOS 
is at location ’0005H’ where a jump to FBASE is found. The address field at 
’0006H’ contains the value of FBASE and can be used to determine the size of 
available memory, assuming the CCP is being overlayed by a transient program. 

• - jjg* 

The transient program may use the CP/M I/O facilities to communicate with the 
operator’s console and peripheral devices, including the drive subsystem. The I/O 
system is accessed by passing a ’function number' and an ’information address' to 
CP/M through the FDOS entry point at location 0005H. In the case of a disk read, 
for example, the transient program sends the number corresponding to a disk read, 
along with the address of an FCB to the CP/M FDOS. The FDOS, in turn, 
performs the operation and returns with either a disk read completion indication or 
an error number indicating that the disk read was unsuccessful. 
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All disk-dependent portions of CP/M are placed into a BIOS-resident ‘Disk 
Parameter Block*. The end user need only specify the maximum number of active 
disks, the starting and ending sector numbers, the data allocation size, the maximum 
extent of the logical disk, directory size information, and reserved track values. 
The macros use this information to generate the appropriate tables and table 
references for use during CP/M operation. Use of these subroutines, together with 
the table driven data access algorithms, make CP/M truly a universal data 
management system. 

It should be mentioned that any or all of the CP/M component subsystems can be 
"overlayed" by an executing program; that is, once a program is loaded into the 
TPA, the CCP, BDOS, and BIOS areas can be used as the program's data area. A 
‘bootstrap* loader is programmatically accessible whenever the BIOS portion is not 
overlayed; therefore, the program need only branch to the bootstrap loader at the 
end of execution, and the CP/M user interface is reloaded from system memory. 
The result of overlaying the BIOS area is a direct return to the EXECUTIVE 
monitor; a warm boot is not possible without the BIOS, thereby making a cold boot 
necessary to return to the VECTOR 4 CP/M operating system. 

All commands to CP/M from a program are accomplished through 'system calls* or 

routines within CP/M which will perform specific low level functions, such as 

getting a character from the keyboard or displaying text on the terminal. System 
calls are used in the program whenever control of the computer is passed to CP/M 
to accomplish a specific task. Control is then returned to the program by CP/M 
once that task has been executed. 

System calls are executed by an instruction passed to the CP/M entry point, which 
is contained in the reserved memory area below 0100H. The entry point is located 
at 0005H and is a ‘JMP’ instruction to the actual entry point in the BDOS; 
however, because CP/M resides in the top portion of memory, the actual entry point 
Maybe different for each system. 

When a program passes a system call, the most common place where information can 

be passed is in the internal registers of the CPU; however, if the amount of 

information that needs to be passed can't be stored in the registers, the protocol 
specifies that a block of memory be set up with the information in it and the 
address of that block of memory be passed in the registers. 

The first piece of information passed to CP/M from the program is the specific call 
needed to execute a particular function. Each system call is assigned a number, 
which is placed in register C prior to executing the instruction to get CP/M. 
CP/M will then read the C register, determine which call was requested, and 
execute that function. Often information, in addition to the system call number, 
needs to be passed to CP/M; e.g., to change the beginning memory address of the 
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disk I/O buffer which CP/M uses for all disk read/write operations, a 16-bit address 
needs to be passed to CP/M as well as the system call number. Generally, 8-bit 
values, such as a character to be output to the terminal, are passed from CP/M to 
the calling program in the Accumulator (register A), and to CP/M in register E. 
The 16-bit values, however, such as addresses, are passed in register DE. 

This section will detail the protocol which the programmer must follow in order to 
pass interface information between the calling program and the VECTOR 4 CP/M 
operating system. It will detail the file control structure on disk and the logical 
mechanisms CP/M uses to manage the files and disk space. In this section are 
detailed descriptions of each operating system call (BDOS functions), with the entry 
parameters and the values that are returned to the calling program. 


4.2 VECTOR 4 CP/M FILE STRUCTURE 

A* HLEHAMES 

VECTOR 4 CP/M organizes the files on a disk with particular regard for 
the names that have been assigned to the files. The filenames are used to 
build a directory, which is used in accessing files where each floppy 
diskette or each logical hard disk drive has its own directory. CP/M 
stores the directory beginning at the first track and sector following the 
reserved system tracks. 

The disk filenames consist of three parts: the drive select code, the 

filename consisting of from one to eight non-blank characters, and the 
extension consisting of zero to three non-blank characters. The extension 
identifies the generic category of a particular file while the filename 
distinguishes individual files in each category. The extensions listed below 
in Exhibit 4-1 name a few generic categories which have been established, 
although they are generally arbitrary: 

Exhibit .4 -1 , . GENERIC . J^TE NSI Q NS 


ASM 

Assembler Source 

PLI 

PL/I Source File 

PRN 

Printer Listing 

OVL 

PL/I Overlay file 

HEX 

Hex Machine Code 

DAT 

Program data file 

BAS 

Basic Source File 

BAK 

Backup file 

SYM 

Symbol File 

LNK 

PLINK Link command file 

COM 

CCP Command File 

REL 

Relocation Module 

$$$ 

Temporary File 

SUB 

Submit file 

MAP 

PLINK Map file (compiled BASIC) 
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En records 

While tracks and sectors divide a disk physically, records, blocks or ’allocation 
blocks’ and extents are the units CP/M uses to organize files logically. 
Information is transferred to and from a disk by moving it on a block basis; 
that is, by moving 128-byte blocks of data at a time. CP/M refers to these 
128-byte blocks as ’records’. 

A distinct feature of CP/M is that files can be any size from 0 to 8 
megabytes. CP/M allows file compaction or expansion in size. CP/M makes 
this elasticity possible by managing logical storage units called 'allocation 
blocks’. 

Cm. ALL.Q C ATIQ K . BL O C K S 

The size of an allocation block varies depending on the type of disk being 
used. Exhibit 4-2 describes the allocation blocks for each of the disks 
currently being used in Vector systems. CP/M numbers the allocation blocks 
consecutively beginning with the first track and sector, following the reserved 
system tracks, and continuing until the last sector on the disk has been 
numbered. As different disks reserve a different number of system tracks, the 
track and sector where the directory begins will vary; however, the reserved 
system tracks will always be the first tracks on the disk and the directory 
will follow on the next track(s). 

As a file gets larger, CP/M assigns new allocation blocks for it, and as it gets, 
smaller, or is deleted, CP/M reclaims allocation blocks. In this fashion, the 
operating system can always account for the space available on disk and a 
file’s contents can be spread across the disk in randomly located sectors. The 
records may be considered logically adjacent but they may not be physically 
adjacent on disk. 
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4-2. ALLOCATION PARAMETER TABLE 


TYPE 
OF DISK 
USED 

RECORDS 

PER 

TRACK 

RECORDS 

PER 

SECTOR 

RESERVED 

TRACKS 

RECORDS 

PER 

ALLOCATION 

BLOCK 

SECTORS 

PER 

ALLOCATION 

BLOCK 

5 1/4” 
Single 
Sided 
Floppy 

32 

2 

2 

16 

8 

5 1/4” 
Double 
Sided 
Floppy 

32 

2 

4 

16 

8 

5 1/4” 

Hard 

Disk 

64 

2 

4 

32 

16 


NOTE: All Vector 4 disks have 256-byte sectors. Even numbered records are 
stored in the first half of the sector and odd numbered records are stored in the 
second half of the sector. 

EL EXTENTS 

The final unit of measure needed to complete the file structure is called an 
extent. A logical extent is equal to 128 records, or 16K of memory. 

Files in CP/M can be thought of as a sequence of up to 65,536 records of 128 
bytes each, numbered from 0 through 65,535, or they can be thought of as 512 
logical extents of 16K each. Internally, all files are broken into logical 
extents so that counters are easily maintained as 8-bit values. However, the 
decomposition into extents is of no particular consequence to the programmer 
since each extent is automatically accessed in both sequential and random 
access modes. THe important point to remember is that CP/M files can be as 
large as 8 megabytes in length. 
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4.3 FILE CONTROL BLOCKS 

Earlier it was noted that the filenames on disk are used to construct a directory 
for each drive. The directory contains an entry for each extent of each file. 
Using the filename as a starting point, CP/M constructs a File Control Block (FCB) 
which contains pointers to the data on disk. The FCB consists of a sequence of 33 
bytes for sequential access and a series of 36 bytes in the case that the file is to 
be accessed randomly. 

An example of the File Control Block format appears in Exhibit 4-3 below. Each 
field of the FCB must be filled in properly before a disk I/O system call is issued. 
Generally, it is the programmer’s responsibility to fill in the lower 16 bytes and 
initialize the ’cr’ field. Normally, bytes 1 through 11 are set to the ASCII 
character values for the filename and extension, while all other fields are zero. 

Exhibit 4-3. FILE CONTROL BLOCK FORMAT 


I I 

I:dr:fl:f2//:f8:el:e2:e3:ex:sl:s2:rc:d0://:dn:cr:r0:rl:r2: | 

I I 

I 00 01 02.. .08 09 10 11 12 13 14 15 IS.. ..31 32 33 34 35 | 


Where: 

dr drive code (0-16) 

0=> use the default drive for the file 
1=> auto disk select drive A 
2=> auto disk select drive B 


16=> auto disk select drive P 

fl.~f8 Contain the filename in ASCII 

el, e2, e3 Contain the extension in ASCII, 

with high bit = 0; el’, e2’, e3’ denote 
the high bit (7) of these positions, 
el’ = 1 => Read/Only file, 
e2’* = 1 => SYS file, no DIR list 

ex Contains the current extent number, which is normally set to 

00 by the programmer but can be in the range 0-31 during file 
input and output (5 bits). 
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si Reserved for internal use. Contains MOD number- 4 bits which 

when combined with 'ex' provides a 9 bit value that specifies 
one of 5 possible extents. 

s2 Reserved for internal use. Set to 80H on call to OPEN, 

MAKE or SEARCH. 

rc Record count beginning of extent 'ex', takes on a value from 

0-128 (128 records x 128 bytes/record = 1 extent = 1 block). 

d(f...dn Disk allocation map reserved for system use and maintained by 

CP/M; contains the allocation block numbers. 

cr Current record to read or write in a sequential file operation, 

normally set to zero by the programmer. 

r0, rl, r2 Optional random record number in the range 0-65,535 with 
overflow to r2. R0, rl constitute a 16-bit value with low byte 

r0 and high byte rl. 

On using the OPEN or MAKE function and providing a blank FCB containing only 
an ufn, the BDOS will scan the directory of the drive that is indicated and match 
the user supplied ufn with a filename in the disk directory. The BDOS will then 
complete the FCB in memory, retrieving the allocation pointers from the FCB on 
disk. The Directory structure is the same as the FCB structure, except taht the 
first byte consists of the user area (0-16) and the structure only includes the first 
32 bytes. 

CP/M will update the allocation block map in the FCB in memory as new data is 
written to the file or as data is erased from the file. When file updating has been 
completed, the new FCB must be written to the disk using the CLOSE system call. 
Remember that once a file has changed size, it must always be closed or the new 
revision will be lost. 

The FCB may be located anywhere in memory. When making file related system 
call operations the address of the FCB is passed in register DE. Transient 
programs often use the default FCB area reserved by CP/M at location 005CH for 
simple file operations. This default location can be used for random access files, 
since the three bytes ’’starting at location 007DH are available for this purpose. 
Often, transient programs will specify two filenames for operation. The CCP 
constructs the first sixteen bytes of two optional FCBs for a transient by scanning 
the remainder of the line following the transient command name. The first FCB is 
constructed at location 005CH, and can be used ’as-is* for subsequent file 
operations. The second FCB occupies the d0...dn portion of the first FCB, and 
must be moved to another area of memory before use. 
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If, for example, the user wants to copy a file and change the name using the PIP 
program, he would enter: 

PIP B:DATA.MEM=INP UT.DAT 

the file PIP.COM is loaded into the TPA, and the default FCB at location 005CH is 
initialized to drive code 2, filename ’DATA and extension ’MEM’. All remaining 
fields through ’cr’ are set to zero. If two separate filenames were given, the 
second would be automatically parsed and placed at location 006CH. Note that it 
is the programmer’s responsibility to move this second filename and extension to 
another area, usually a separate FCB, before opening the file which begins at 
location 005CH, because the open operation will overwrite the second filename and 
extension. 

If no filenames are specified in the original command, the fields beginning at 

location 005DH and 006DH will contain blanks. In all cases, the CCP translates 

lower case alphabetics to upper case to be consistent with the CCP file naming 
conventions. As an added convenience, the default buffer area at location 0080H is 
initialized to the command line entered by the programmer following the program 
name. The first position contains the number of characters, with the characters 
themselves following the character count. Given the above command line, the area 
beginning at location 0080H is initialized as follows: 

Location M8QH 

+00 +01 +02 +03 +04 +05 +06 +07 +08 +09 +0A +0B +QC +0D +0E . . . 

jj » » ngw n.n njyt n^a ipjw a^a a a aiga nj^jn a-a njw njjw 

where the characters are translated to upper case ASCII with uninitialized memory 
following the last valid character. Again, it is the responsibility of the programmer 
to extract the information from this buffer before any file operations are 
performed, unless the default DMA address is explicitly changed. 

A 128-byte record default location for disk I/O is provided by VECTOR 4 CP/M at 
location 0080H, which is the initial default DMA address (see function 26). If 
either the SEARCH FIRST (function 17) or SEARCH NEXT (function 18) is 
successful in finding a user specified file, it will return a directory record 
(consisting of four directory entries) at the DMA address, destroying any information 
residing there. 

CP/M treats ASCII files as a sequence of ASCII characters, where each 'line' of 
the source file is followed by a [RETURN] line-feed sequence (0DH followed by 
0AH). Therefore, one 128-byte CP/M record could contain several lines of source 
text. The end of an ASCII file is denoted by a [CTRL Z] character (lAH) .or a 
real end-of-file, returned by the CP/M read operation. 
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[CTRL Z] characters embedded within machine code files (e.g., COM files): are 
ignored, however, and the end-of-file condition returned by CP/M is used to 
terminate read operations. 

Memory located from ’0000H to 00FFH is called the ’base page’. The base page 
contains several segments of code and data that are used by transient programs 
while running under VECTOR 4 CP/M; the code and data areas are shown for 
reference in Exhibit 4-4. Addresses are relative to the beginning of the memory 
segment. 


4-4. BASE PAGE AREAS 


AddESBi Contents 

9999R-9992H Contains jump instruction to the BIOS termination entry point 

at BIOS + 3 (warm boot). 

W03H Contains the IOBYTE. 


9994H 

9995B.-9997H 


0W8H-0037H 


High-order nybl = User Number 
Low-order nybl = Drive Number 

Contains jump instructions to the BDOS: 

JMP 0005H provides primary entry point to the BDOS, 

LHLD 0006H places the jump instruction address field into 
register HL. 

This value, minus one, equals the highest address of memory 
that is available to the program. MOTEt DDT and RAID 
programs will change this address field to reflect the reduced 
memory size. 

Reserved Restart locations 1-6. 


0038H-003FH Restart 7 - Contains a jump instruction into the DDT, when 

running in debug mode for programmed breakpoints; otherwise 
not used by VECTOR 4 CP/M. 

9040H-905BH Reserved - not currently used. 

905CH-907BH Default FCB (area 1) initialized by CCP for a program from 

existing first command-tail operand of command line. 
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W6CHHW7BH 


W7CH 

W7DH-007FH 

008(lHHIiJFFH 


Default FCB (area 2) initialized by CCP for a program from 
existing second command-tail operand of command line. This 
area will overlay the last 16 bytes of default FCB (area 1); to 
use this area’s information, the program must copy it to 
another location before using area 1. 

Contains current record position of default FCB (area 1); this 
field is used with area 1 in processing sequential records. 

Contains optional default random record position; this field is 
an extension of area 1 used in processing random records. 

Default disk buffer (128 bytes); filled with command-tail when 
the CCP loads a program. 


4.4 OPERATING SYSTEM CALLS 

1.4 J. . General 

An operating system call (BDOS function) instructs VECTOR 4 CP/M to perform 
specific functions needed to interface a program with the entry, output, and storage 
devices. Generally, the operating calls govern input and output to peripherals such 
as the keyboard or the printer, or they interface the programmer’s instructions with 
the file structure on disk. When such a call is used as part of a program, control 
of the computer is passed from the program to CP/M. CP/M runs the specific 
routine which was requested, returns the result of the operation, and gives control 
of the computer back to the program at the line where the call was initiated. 
Information is passed between the calling program and the CP/M operating system 
by moving values to and from the internal registers of the CPU. If the amount of 
information to be passed cannot be stored in the registers, protocol specifies that a 
block of memory be established with the information in it and the address of that 
block be passed in the registers. 

A call to the CP/M operating system must include a function number which 
specifies the operation being required, and may include a single-byte word such as 
an ASCII character or a double-byte word such as an information address. 
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The Z80B CPU in your Vector 4 System has 22 principal registers including twin 
register sets comprised of an Accumulator, (Register A), a Status register, and six 
8-bit general purpose registers, B, C, D, E, H and L. 

The first piece of information to be passed is the function number for the specific 
routine that is being requested; the function number is always passed in register C. 
Single-byte values (8-bit values) are passed to CP/M in register E and returned in 
the Accumulator. Double-byte values are passed to CP/M in the double-byte pair 
DE and returned in registers HL. 

NOTE: For reasons of compatibility, register A = L and register B = H upon 

return in all cases. Note that the register passing conventions of CP/M agree with 
those of Intel’s PL/M systems programming language. If a call to a function within 
the BDOS is not implemented under the current version of VECTOR 4 CP/M, the 
C register will contain ’FF’ on return. 

Upon entry to a transient program, the CCP leaves the stack pointer set to an 
eight level stack area with the CCP return address pushed onto the stack, leaving 
seven levels before overflow occurs. Although this stack is usually not used by a 
transient program (i.e., most transients return to the CCP through a jump to 
location 0000H), it is sufficiently large enough to make CP/M system calls since the 
FDOS switches to a local stack at system entry. 

The following assembly language program segment, for example, reads characters 
continuously until an asterisk is encountered, at which time control returns to the 
CCP. 


BDOS EQU 

0005H 

GCNIN EQU 

1 

CBG 

010 OH 

NEXICtMVI 

C,CCNIN 

CALL 

EDCS 

CPI 

t* t 

JNZ 

NEXIC 

RET 


END 



iSTANDAKD CP/M ENTRY 
iCCNSCLE INPUT FtNCTICN 

BASE OF TPA 
READ NEXT CHARACTER 
REi™ CHARACTER IN <A> 
END OF PROCESSING? 

LOOP IF NOT 
RETURN TO CCP 


4.4.2 Functional .Description 

The function number and a short description of each system call follows Exhibit 4-5 
at the end of this section shows a summary chart for all functions: 


Rev. A - 9-01-82 


P/N 7100-0003 


4-11 



VECTOR GRAPHIC, INC, 


E m cnQN-Q; SYSTEM RESET 


Entry Parameters: : Register C - 00H 

The SYSTEM RESET function will return control to the VECTOR 4 CP/M 
operating system at the CCP level. All records and files locked by the 
calling program are released. The CCP reinitializes the disk subsystem by 
selecting and logging-in Drive A. To this particular process, this has exactly 
the same effect as a freshly booted system. 


FUNCTION Is CONSOLE INPUT 


Entry Parameters: Register C - 01H 

Returned Value: Register A - ASCII Character 

The CONSOLE INPUT function will read the next console character to 
register A. Graphic characters, along with carriage return, line feed, and 
backspace, [CTRL H], are echoed to the console. The FDOS does not return 
to the calling program until a character has been typed, thus suspending 
execution if a character is not ready. 


FUNCTION 2: CONSOLE OUTPUT 


Entry Parameters: Register C - 02H 

Register E - ASCII Character 

The CONSOLE OUTPUT function will send the ASCII character from 
register E to the console device. Similar to function 1, tabs are expanded and 
checks are made for terminate process, start/stop scroll and printer echo. 
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E- U H.GEKttL 3; READER EiEPl 


Entry Parameters: Register C - 03H 

Returned Value: Register A - ASCII Character 

The READER INPUT function will read the next character from the logical 
reader into register A. Control does not return until the character has been 
read. This function (along with function 4) are included even though it is 
realized that the Vector 4 may never be connected to a READER or PUNCH 
device. These functions can be used "logically" to connect other types of 
devices to the Vector 4. 

FUNCTION 4; PUNCH OUTPUT 


Entry Parameters: Register C - 04H 

Register E - ASCII Character 

The Punch Output function will send the character from register E to the 
logical punch device. 


EM CT QIi- 5 «_ .LIS T . .O UT P U T/ 


Entry Parameters: • Register C - 05H 

Register E - ASCII Character 

The LIST OUTPUT function will send the ASCII character in register E to the 
selected logical listing device. In the event that the spooler is being used and 
a disk error occurs, the function returns 0FFH in register A, otherwise a 0 is 
returned in register A. 
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F U N CT ION 6; DIRECT .CONSOLE I/Q 


Entry Parameters: Register C - 06H 

Register E - 0FFH - Console Input/Status 
0FEH - Keyboard Status 
0FDH - Input 
ASCH character (Output) 

Returned Value: Register A - Status or ASCII Character (No Value) 

The DIRECT CONSOLE I/O function is supported under CP/M for those 
specialized applications where unadorned console input and output is required. 
Use of this function should, in general, be avoided since it bypasses all of 
CP/M’s normal control character functions (e.g., [CTRL S], [CTRL X]). 
Programs which perform direct I/O through the BIOS under previous releases of 
CP/M, however, should be changed to use direct I/O under the BDOS so that 
they can be fully supported under future releases of CP/M. 

Upon entry to function 6, register E either contains a hexadecimal value 
FDH - FFH, denoting a console input request, or an ASCII character. If the 
input value is not in the range 0FDH - 0FFH, function 6 will output the 
character in the E register to the system console. 

REGISTER E: MEANING: 


0FFH 

0FEH 

0FDH 


ASCH 


Console Input and status: register A = input character 

or if no character is ready, zero is returned. 

Console status: register A = 00 if no character is 

ready or FF if a character is available at the console. 

Console input: returns an input character in register A 

and will suspend the calling process until a character is 
ready. 

Console output:- Sends value in register E to the 
console. No value returned in register A. 
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FUNCTION 7: GET_.IQRY.TE 


Entry Parameters: Register C - 07H 

Returned Value: . Register A - IOBYTE Value 

The GET IOBYTE function will return the current value of the IOBYTE in 
register A. 

E U NC TION 3 ; SET IOBY T E 


Entry Parameters: Register C - 08H 

Register E - New IOBYTE value 

Returned Value: Register A - Return Code 

The two most significant bits of the IOBYTE are used to define the 
destination of the list output stream. A value of ’0* for the two bits 

specifies that all list output is to be discarded. A value of 'l* selects echo 

to console and values of ’2* and *3’ select list device one and list device two, 
respectively. 

All changing of the IOBYTE should be done using this function. The least 
significant 6 bits are reserved for future use and should be maintained when 

changing the list device. This can be accomplished by first getting the 

IOBYTE (see function 7) and making only the necessary changes and then 
performing function 8. 

In the event that the user attempts to select a printer which is busy (the 
printer is being used by the despooler or by another process), the IOBYTE will 
not be altered and an 0FFH will be returned in the A register; in other cases 
the A register will return a 00H. 
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g.TO CT IQg - 8; PRINT STRING 


Entry Parameters: • Register C - 09H 

Registers DE - String Address 

The PRINT STRING function will send the character string stored in memory 
at the location given by DE to the console device, until a ’$’ is encountered 
in the string. Tabs are expanded as in function 2, and checks are made for 
terminate process, start/stop scroll, and printer echo. To print a 
character, set bit 7 of the character and the '$’ will not be recognized as an 
end of string delimeter. 


FUNCTION 10: READ CONSOLE BUFFER 

Entry Parameters: Register C - 0AH 

Register DE - Buffer Address 

Returned Value: Console Characters in Buffer 

The READ BUFFER function will read a line of edited console input into a 
buffer addressed by register DE. Console input is terminated when the input 
buffer overflows. The Read Buffer takes the form: 

DE: +0 +1 +2 +3 44 +5 +6 +7 +8 ... +n 


:mx:nc:cl:c2:c3:c4:c5:c6:c7: ... :??: 


where ’mx* is the maximum number of characters which the buffer will hold (1 
to 255), ’nc* is the number of characters read (set by FDOS upon return), 
followed by the characters read from the console. If the number of 
characters read did not fill the buffer to capacity, (nc is less than mx), then 
uninitialized positions follow the last character, denoted by *??’ in the above 
figure. A number of control functions are recognized during line editing: 


[CIHL C] Reboots when at the beginning of line 
[CIEL E] Causes physical end of line 
[CTRL H] Backspaces one character position 
[CTRL J] (Line feed) terminates input line 
[CIHL M] (Return) terminates input line 
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[COIL R] Retypes the current line after new line 
[CIRL U] Removes current line after new line 
[CIRL X] Backspaces to beginning of current line 
[CTRL K] Form feeds current list device 
[CIRL P] Toggles printer echo 
[EEL] Same as [CIRL H or [BACKSPACE] 

Note also that certain functions which return the carriage to the leftmost 
position (e.g., [CTRL X]) do so only to the column position where the prompt 
ended (in earlier releases, the carriage returned to the extreme left margin). 
This convention makes operator data input and line correction more legible. 
The input string will be terminated by a null. 


FUNCTION 11: GET CONSOLE STATUS 


Entry Parameters: Register C - 0BH 

Returned Value: Register A - Console Status 

The CONSOLE STATUS function will check to see if a character has been 
entered at the console. If a character is ready, the value 0FFH is returned 
in register A; otherwise, a 00H value is returned. 


FU NCTION 12; RETURN. VE RSION NU MSEB 


Entry Parameters: Register C - 0CH 

Returned Value: Registers HL - Version Number 

The RETURN VERSION NUMBER function will provide information which 
allows version independent programming. A two-byte value is returned, 
L = 00, for all releases previous to Version 2.0. CP/M 2.0 returns a 
hexadecimal *20’ in register L, with subsequent Version 2.0 releases in the 
hexadecimal range 21 and 22 through 2F. VECTOR 4 CP/M will return a 
value greater than or equal to '25 H*. 

Using function 12, for example, application programs can be written which 
provide both sequential and random access functions, with random access 
disabled when operating under early releases of CP/M. 
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F.M.CTIQN....13 : R ESET. JDIS&-, SYS T EM 


Entry Parameters; • Register C - 0DH 

Returned Value; Register A - Return Code 

Register H - Physical or Logical Error 

The RESET DISK SYSTEM function will initialize the BDOS, reset the 
Read/Write state for all disks, selects Drive A, and sets the default DMA to 
80H. Normally, it returns 00H in register A; however, if a SUBMIT file is open 
on the drive, this function returns 0FFH in register A. If a physical error is 
returned during drive select, register H will return the physical error code 
(see Appendix A for a discussion of errors). 


FUNCTION 14; SELECT DISK 


Entry Parameters; Register C - 0EH 

Register E - Selected Disk 

Returned Value; Register A - Return Code 

Register H - Physical or Logical Error 

The SELECT DISK function will designate a drive as the default drive for 
subsequent file operations, with the value in register E = 0 for Drive A, 1 for 
Drive B, etc., through 15 corresponding to Drive P in a full sixteen drive 
system. 

The drive is placed in an ’on-line' status which, in particular, activates its 
directory until the next cold start, warm start, or disk system reset operation. 
If the disk media is changed while it is on-line, the drive automatically goes 
to a Read-Only status in a standard CP/M environment (see function 28). 
FCBs which specify drive code zero (dr = 00H) automatically reference the 
currently selected default drive. FCBs with drive code values between 1 and 
16, however, ignore the selected default drive and directly reference Drives A 
through P. 
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If the SELECT DISK operation was successful, register A is zero upon return. 
If a physical error is returned, register A is 0FFH and one of the following 
physical error codes is returned in register H: 

01 - Permanent error 
04 - Select error 

(See Appendix A for description of error modes) 


FUNCTION 15s OPEN FILE 


Entry Parameters: Register C - 0FH 

Register DE - FCB address 

Returned Value: Register A - Directory Code 

Register H - Physical or Logical Error 

The OPEN FILE function is used to activate a file which has already been 
written to the disk for the currently active user number. The BDOS scans the 
disk directory for a match in positions 1 though 14 with the FCB referenced 
by register DE. Note that if a file is to be accessed sequentially starting at 
record 0, the current record byte (’cr’) must be zeroed (byte si is 
automatically zeroed). Normally, no question marks are included and, further, 
bytes ’ex’ and ’s2* of the FCB are zero. An error will occur if any field in 
the filename contains a ’?'. 

If a directory entry is matched, the relevant directory information is copied 
into bytes d0 through dn of the FCB, thereby allowing subsequent file access 
in read or write operations. At the same time, an FCB checksum is computed 
and is used to verify that the file hasn't been changed by another process or 
task during subsequent operations. 

Attribute bits f 5 * and f 6 T of the filename in the FC3 specify in which of 
three modes the file will be opened: 

f6’: f5’: MODE: 


0 

0 

1 


0 * LOCKED MODE (DEFAULT) 

1 UNLOCKED MODE 
0 or 1 READ-ONLY MODE 
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Opening files in the Locked mode prevents other tasks from accessing the 
same files. 

Opening files in the Unlocked mode allows other tasks to access the same file, 
unless the user locks specific records which then prevents other tasks from 
accessing those records of the file. 

Opening files in the Read-Only mode allows only read operations. The 
Read-Only mode allows access for other tasks to the file provided that they 
also open it in the Read-Only mode. 

When an open is successful, the opened file is registered in a File Lock list. 
While this file remains in the list, no other task can perform any operations on 
the file in any mode other than the mode specified by the current task. Also, 
no other task can delete, rename or modify any of the file’s attributes. The 
file remains in the lock list until permanently closed or the task that opened 
it terminates. 

Note that an existing file must not be accessed until a successful open 
operation has been completed. 

The OPEN function returns a ’directory code’ with a value of 0 through 3 if 
the OPEN was successful, or 0FFH (255 decimal) if the file cannot be found. 
Register H is set to zero in both of these cases but if a physical or logical 
error is returned, register H contains one of the following error codes: 

01 - PERMANENT ERROR 

04 - SELECT ERROR 

05 - FILE OPEN BY ANOTHER PROCESS OR BY CURRENT PROCESS 
IN AN INCOMPATIBLE MODE 

09 - ’?’ IN FILENAME OR EXTENSION FIELD 

10 - PROCESS OPEN FILE LIMIT EXCEEDED 

11 - NO ROOM IN THE SYSTEM LOCK LIST 

(See Appendix A for Error messages) 


EUNCTIQN l&i - C L Q SE..FILE 


Entry Parameters: Register C - 10H 

Register DE - FCB address 
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Returned Value: Register A - Directory Code 

Register H - Physical/Logical Error 
Registers DE - FCB Address 

The CLOSE FILE function will perform the inverse function of OPEN FILE. 
Given that the FCB addressed by DE has been previously activated through an 
OPEN or MAKE function (see functions 15 and 22), CLOSE will write the new 
FCB to the referenced disk directory. The FCB matching process for the 
CLOSE is identical to the OPEN function. Interface attribute f 5 ’ is used to 
specifies the mode in which the file is to be closed: 

f 5* MODE 


0 Permanent close (default) 

1 Partial close 

The CLOSE FILE function will first verify that the referenced FCB has a 
valid checksum; if it is valid and the referenced FCB contains new information 
because of write operations to the FCB, the function permanently records the 
new information in the referenced disk directory. 

The FCB will not contain new information and the directory update step is 
bypassed if only READ and/or UPDATE operations have been made to the 
FCB. The function, however, always attempts to locate the corresponding 
FCB entry in the directory and will return an error if the entry cannot be 
found. 

If the CLOSE has performed successfully and is permanent, the function 
removes the file's item from the system lock list; if the FCB was opened in 
unlocked mode, it also deletes all the file's record lock items from the system 
lock list. Since the file’s lock list item has been removed, the function will 
invalidate the FCB checksum to ensure that the FCB cannot be subsequently 
used with other BDOS functions requiring an open FCB. 

In the event that a partial close is performed, the FCB and directory will be 

updated as above. The file list information is not removed, however, and the 

FCB checksum remains valid to allow further file access. 

* 

A successful operation returns 0, 1, 2, or 3 in register A, while 0FFH (255 
decimal) is returned if the file name cannot be found in the directory; 
register H is set to zero in both cases. However, if the file has been written 
to, it must be closed or the new data will be lost. 
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Opened files should always be closed to optimize system operations in systems 
utilitizing file tracking or in systems maintaining active file lists. When a 
physical error is returned, register A is 0FFH and register H will display one 
of the following: 

01 - PERMANENT ERROR 

02 - READ-ONLY DISK 

94 - SELECT ERROR 

06 - FCB CHECKSUM ERROR 


FUN CT IO N ,. 1 7 » S EARCH .F O R . FIRST 


Entry Parameters: • Register C - 11H 

Register DE - FCB Address 

Returned Value: Register A - Directory Code 

Register H - Physical or Logical Code 

The SEARCH FIRST function will scan the directory for a match with the file 
given by the FCB addressed by DE. If the file is found, the current DMA 
address is filled with the record containing the directory entry, and the 
relative starting position is A * 32 (i.e., rotate the register A left 5 bits, or 
ADD ’A f five times). Although not normally required for application programs, 
the directory information can be extracted from the buffer at this position. 

An ASCII question mark (63 decimal, 3F hexadecimal) in any position from *fl T 
through ’ex’ matches the corresponding field of any directory entry on the 
default or auto-selected disk drive. If the ’dr' field contains an ASCII 
question mark, then the auto disk select function is disabled, the default disk 
is searched, with the search function returning any matched entry, allocated or 
free, belonging to any user number. This latter function is not normally used 
by application programs, but does allow complete flexibility to scan all current 
directory values. If the 'dr* field is not a question mark, the ’s2' 
byte is automatically zeroed. 

The value 255 (hexadecimal FF) is returned if the file is not found, otherwise 
0, 1, 2, or 3 is returned indicating the file is present. In either case, 
register H is zerd. If a physical or logical error is returned, register A 
contains 0FFH and register H contains one of the following error codes: • 

01 - PERMANENT ERROR 
04 - SELECT ERROR 
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miCHQ& IS; SEARCH FOR. NEXT 

Entry Parameters: Register C - 12H 

Returned Value: Register A - Directory Code 

Register H - Physical or Logical Error Code 

The SEARCH NEXT function will find the next occurence of a match after 

Function 17 is used. It returns the decimal value of 255 in register A when 

no more directory items match. 

NOTE: Vector has changed SEARCH NEXT so that it will keep track of its 

last position in the directory. In this way other disk functions (i.e., DELETE 
file, RENAME file) may be executed in the middle of a search. 

If a physical or logical error is returned, register A contains 0FFH and 
register H contains one of the following error codes: 

01 - PERMANENT ERROR 
04 - SELECT ERROR 

FUNCTION 19: DELETE FILE 


Entry Parameters: - Register C - 13H 

Register DE - FCB address 

Returned Value: Register A - Directory Code 

Register H - Physical or Logical Error 

The DELETE FILE function will remove files which match the FCB addressed 
by register DE. The filename and extension may contain ambiguous references 
but the drive select code must be unambiguous, as in the SEARCH and 
SEARCH NEXT functions. An open file can be deleted if opened in locked 
mode by the same process; however, a checksum error will be returned if a 
further reference to the file occurs using a BDOS function that requires an 
open FCB. Open Read-Only or unlocked files cannot be deleted. 

DELETE FILE will return a decimal ’255’ if the referenced file or files cannot 
be found; otherwise, a value in the range of 0 to 3 is returned if the delete 
was successful. 
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In both cases, register H is set to zero. If a physical or logical error is 
returned, register A contains 0FFH and register H contains one of the 
following error codes: 

01 - PERMANENT ERROR 

02 - READ-ONLY DISK 

03 - READ-ONLY FILE 

04 - SELECT ERROR 

05 - FILE OPEN BY ANOTHER PROCESS OR BY CURRENT PROCESS 
IN AN INCOMPATIBLE MODE 


FUNCTION 20: READ SEQUENTIAL 


Entry Parameters: Register C - 14H 

Register DE - FCB Address 

Returned Value: Register A - Error Code 

Register H - Physical or Logical Error 

The READ SEQUENTIAL function will read the next one to sixteen 128-byte 
records from a file into memory beginning at the current DMA address. The 
BDOS function 44 will determine the number of records to be read; the 
default is one record. The FCB addressed by register DE must already be 
activated by an OPEN or MAKE function call in order that this function can 
read the next record from the file into memory at the current DMA address. 
Each record is read from position f cr’ of the extent, then the ’cr* field is 
automatically incremented to the next record position. If the ’cr* field 
overflows, the next logical extent is automatically opened and the ’cr* field is 
reset to zero, to prepare for the next READ operation. The value 00H is 
returned in the A register if the read operation was successful; otherwise, one 
of the following errors is returned if no data exists at the next record 
position or if a physical or logical error is returned: 

01 - READING UNWRITTEN DATA 

08 - RECORD LOCKED BY ANOTHER PROCESS 

09 - INVALID FCB 

11 - UNLOCKED FILE VERIFICATION ERROR 
255 - PHYSICAL ERROR (REFER TO REGISTER H) 

i 

gKTSI CA L-ERRQ R ., C ODES; ( FQ.UK LE AST S IGNIFI CA N T . . B ITS j Q £ _Hl 

01 - PERMANENT ERROR 
04 - SELECT ERROR 
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E 


IKWI 


[O N ,21; .. .W R ITE SEQUENTIAL 


Entry Parameters: Register C - 15H 

Register DE - FCB Address 

Returned Value: Register A - Return Code 

Register H - Physical or Logical Error 

The WRITE SEQUENTIAL function will write one to sixteen 128-byte records 
beginning at the current DMA address into the file named by the FCB 
addressed in register DE. BDOS function 44 (SET MULTI-SECTOR COUNT) 
will determine the number of 128-byte records that are written; the default is 
one record. The FCB must have been activated previously by an OPEN or 
MAKE function call. If the FCB has been activated through an OPEN or 
MAKE function, the WRITE SEQUENTIAL function win write 128 bytes starting 
at the current DMA address to the file named by the FCB. The record is 
placed at position ’cr’ of the file, and the 'cr* field is automatically 
incremented to the next record position. If the ’cr’ field overflows then the 
next logical extent is automatically opened and the ’cr* field is reset to zero. 
Write operations can take place into an existing file, in which case newly 
written records overlay those which already exist in the file. The WRITE 
function will, upon return, set register A to zero if the operation was 
successful; otherwise, A may contain one of the following error codes. If a 
physical or logical error is returned, register A will be 0FFH and the error 
code will consist of one of the following in register H: 

01 - WRITE MODE: NO DIRECTORY SPACE 

02 - NO AVAILABLE DATA BLOCKS (Not returned in random mode) 

08 - RECORD LOCKED BY ANOTHER PROCESS 

09 - INVALID FCB 

10 - FCB CHECKSUM ERROR 

11 - UNLOCKED FILE VERIFICATION ERROR 

255 - PHYSICAL ERROR (REFER TO REGISTER H) 

PHYSICAL ERROR CODES: (LEAST SIGNIFICANT FOUR BITS IN 

REGISTER H) 

01 - PERMANENT ERROR 

02 - READ-ONLY DISK 

03 - READ-ONLY FILE 

04 - SELECT ERROR 
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FUNCTION 22; MAKE FILE 


Entry Parameters: Register C - 16H 

Register DE - FCB Address 

Returned Value: Register A - Directory Code 

Register H - Physical or Logical Error 

The MAKE FILE function will create a new file under the current user 
number; it is used for files that have never been written to disk. The FDOS 
creates the file and initializes the FCB in memory, as well as on disk, as an 
empty file. Vector Graphic has changed the original CP/M function to prevent 
creation of duplicate files. A checksum is computed and assigned to the FCB; 
BDOS functions that require an open FCB will verify that the FCB checksum 
is valid before performing their operation. The MAKE function has the 
side-effect of activating the FCB and thus a subsequent OPEN is unnecessary. 
(Refer to OPEN FILE function for discussion of attributes.) The READ-ONLY 
mode attribute bit 

(f 6) is ignored by the MAKE FILE funcion. 

This function returns 0FFH in register A if there is no directory space. If 
the operation was successful register A will return 0, 1, 2, or 3. In either 
case, register H is zero; :but if a physical or logical error is returned, 
register H contains one of the following error codes: 

01 - PERMANENT ERROR 

94 - SELECT ERROR 

95 - FILE OPEN BY ANOTHER PROCESS OR BY CURRENT 

PROCESS IN AN INCOMPATIBLE MODE 

08 - FILE ALREADY EXISTS 

09 - *V IN FILENAME OR EXTENSION FIELD 

10 - PROCESS OPEN FILE LIMIT EXCEEDED 

11 - NO ROOM IN THE SYSTEM LOCK LIST 


ZPK CT IQN 23;., RENAME F ILE 


Entry Parameters: 


Register C - 17H 
Register DE - FCB Address 


Returned Value: 


Register A - Directory Code 
Register H - Physical or Logical Error 
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The RENAME FILE function will use the FCB addressed by register DE to 
change all occurrences of the file named in the first 16 bytes to the file 
named in the second 16 bytes. The call will check that the filenames 
specified in the FCB are valid and unambiguous, and that the new filename 
does not already exist on the drive. The drive code ’dr’ at position 0 is used 
to select the drive, while the drive code for the new filename at position 16 
of the FCB is assumed to be zero. 

A file can be renamed by a process if the file was opened in lock mode, but 
if the file is accessed by a function which requires an open FCB, an FCB 
checksum error will be returned. A file cannot be renamed if opened in 
Read-Only or Unlocked mode. 

Upon return, register A is set to a value between 0 and 3 if the rename was 
successful, and 0FFH (255 decimal) if the first filename could not be found in 
the directory scan. In either case register H is zero. If a physical or logical 
error is returned, register A contains 0FFH and one of the following error 
codes is returned in H: 

01 - PERMANENT ERROR 

92 - READ-ONLY DESK 

03 - READ-ONLY FILE OR FILE OPEN IN READ-ONLY MODE 

04 - SELECT ERROR 

05 - FILE OPEN BY ANOTHER PROCESS OR BY CURRENT 

PROCESS IN AN INCOMPATIBLE MODE 

08 - FILE ALREADY EXISTS 

09 - ’?’ IN FILENAME OR EXTENSION FIELD 


FUNCTION 24: RETURN LOGIN VECTOR 


Entry Parameters: Register C - 18H 

Returned Value: Register HL - Login Vector 

The RETURN LOGIN VECTOR value returned by CP/M is a 16-bit value in 
HL, where the least significant bit of L corresponds to the first Drive A, and 
the high-order bif of H corresponds to the sixteenth drive, labelled P. A ’0’ 
bit indicates that the drive is not on-line, while a '1* bit marks a drive that 
is actively on-line due to an explicit disk drive selection, or an implicit drive 
select caused by a file operation which specified a non-zero ’dr’ field. Note 
that compatibility is maintained with earlier releases, since registers A and L 
contain the same values upon return. 


Rev. A - 9-01-82 


P/N 7100-0003 


4-27 



VECTOR GRAPHIC, INC, 


FUNCTION 25; RETURN CURRENT DISK 


Entry Parameters: * Register C - 19H 
Returned Value: Register A - Current Disk 

The RETURN CURRENT DISK function returns the currently selected default 
disk number in register A. The disk numbers range from 0 through 15 
corresponding to Drives A through P. 

E m c rr mjsffs set dma address 


Entry Parameters: Register C - 1AH 

Register DE - DMA Address 

Direct Memory Address (DMA) is often used in connection with disk controllers 
which directly access the memory of the mainframe computer to transfer data 
to and from the disk subsystem. VECTOR 4 CP/M uses non-DMA access where 
the data is transferred through programmed I/O operations. 

In VECTOR 4 CP/M, the DMA address has come to mean the address at which 
the 128-byte data record resides before a disk write and after a disk read. 
On a cold start, warm start, or disk system reset, the DMA address is 
automatically set to 0080H. The SET DMA function, however, can be used to 
change this default value to address another area of memory where the data 
records reside. Thus, the DMA address becomes the value specified by DE 
until it is changed by a subsequent SET DMA function, cold start, warm start, 
or disk system reset. 

£ m C T IQN_2.T; . G E T A PERJALLQ C ) 


Entry Parameters: Register C - 1BH 

* 

Returned Value: Register HL - ALLOC Address 
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The System maintains an "allocation vector" in the main memory for each 
on-line disk drive (Bitmap). Programs like STAT use this table to determine 
the amount of remaining storage space. Function 27 will return the address of 
the allocation table for the currently selected drive. If the selected disk has 
been marked Read-Only, the allocation information may be invalid. This 
function is not normally used by application programs. Application programs 
should use function 46. 


FUNCTION 28; WRITE PROTECT DISK 


Entry Parameters: • Register C - 1CH 

The WRITE PROTECT DISK function will provide temporary write protection 
for the currently selected disk. Any attempt to write to the disk, before the 
next cold or warm start operation produces the message: 

ERROR - ds DRIVE IS READ-ONLY 

NOTE: A drive can be permanently set to READ-ONLY by using the 

CONFIG D option. 


FUNCTION 29: GET READ/ONLY VECTOR 


Entry Parameters: Register C - 1DH 

Returned Value: Register HL - R/O Vector Value 

The GET READ/ONLY VECTOR function will return a bit vector in 
register HL which indicates drives which have the temporary read-only bit set. 
Similar to function 24, the least significant bit corresponds to Drive A, while 
the most significant bit corresponds to Drive P. The Read-Only bit is set 
either by an explicit call to function 28, or by the automatic software 
mechanisms within CP/M which detect changed disks. 
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F TOCT IQH 3Q» SET FILE ATTRIBUTES 


Entry Parameters: Register C - 1EH 

Register DE - FCB address 

Returned Value: Register A - Directory Code 

Register H - Permanent or Logical Error 

The SET FILE ATTRIBUTES function will set or clear indicators attached to 
files; in particular, the R-0 and System attributes (tl T and t2’) can be set or 
reset. Register DE will address an unambiguous FCB with the appropriate 
attributes set or reset. Function 30 will search for a match and change the 
matched directory entry to contain the selected indicators. Indicator fl* is 
used to make a file 'invisible* to other users (other account nubers); while f2* 
through f4* are not presently used, but may be useful for applications programs 
since they are not involved in the matching process during file open and close 
operations. Indicators f5* and f6* are used during OPEN, MAKE, and CLOSE 
functions to specify access mode; f 7 T , f 8 T and t3* are reserved for future 
system expansion. 

This function cannot be performed on any files opened by another process. It 
can be performed on files opened by the current process in lock mode but any 
subsequent operations which require an open FCB will return a FCB checksum 
error. No attributes may be set on any file open in unlocked or read/only 
mode. 

If successful, this function returns a value of 0 through 3 in register A. If 
the file is not found, register A will return FFH. Register H is zero in 
either case. If a physical or logical error is returned, register A is FFH and 
register H contains one of the following: 

91 - PERMANENT ERROR 

02 - READ-ONLY ERROR 

94 ~ SELECT ERROR 

$15 - FILE OPEN BY ANOTHER PROCESS 

99 - IN FILE NAME OR EXTENSION 


4-30- 


P/N 7100-0003 


9-01-82 - Rev. A 



VECTOR 4 CP/M 
PROGRAMMER'S GUIDE 


FUNCTION 31: GET ADDR (DISK PARMS) 


Entry Parameters: Register C - 1FH 

Returned Value: Register HL - DPB address 

The GET ADDR function will return the address of the BIOS resident Disk 
Parameter Block (DPB) in register HL. The address is useful for computing 
space or for changing the disk parameter values when the disk environment 
changes. Normally, application programs will not require this facility. 


EU N fiPQH. « g SET /G ET USER CODE 


Entry Parameters: Register C - 20H 

Register E - 0FFH (GET) 

Register E - < FFH User Code (SET) (E MOD 32) 

Returned Value: Register A - Current Code (or no value) 

The SET/GET USER CODE function will change or query, within an application 
program, the currently active user number. If register E = 0FFH the value of 
the current user number is returned in register A, where the value is in the 
range of 0 to 31. If register E is not 0FFH, then the current user number is 
changed to the value of E (modulo 32). 


P S NCT IQN 33; READ-RANDOM 


Entry Parameters: Register C - 21H 

Register DE - FCB Address 

Returned Value: Register A - Error Code 

Register H - Physical or Logical Error 

The READ RANDOM function will use the read random field, (the last three 
bytes) of the FCB to select a particular record number and read the record. 
The read operation takes place at a record number indicated by the 24-byte 
value constructed from byte positions r0 at 33, rl at 34, and r2 at 35. Note 
that the sequence of 24 bits is stored with the least significant byte first (r0), 
the middle byte next (rl), and the high byte last (r2). 
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VECTOR 4 CP/M does not reference byte r2, except in computing the size of 
a file (function 35). Byte r2 must be zero because a non-zero value indicates 
overflow past the end of file; therefore, the r0, rl byte pair is treated as a 
double byte, or ’word’ value, which contains the record to read. This value 
ranges from 0 to 65,535 providing access to any particular record of the 8 
Mbyte file. 

In order to process a file using random access, the base extent (extent 0) must 
first be opened. Although the base extent may or may not contain any 
allocated data, this ensures that the file is properly recorded in the directory, 
and is visible in DIR requests. The selected record number is then stored into 
the random record field (r0,rl), and the BDOS is called to read the record. If 
the BDOS Multi-Sector Count is greater than one (see function 44), the READ 
RANDOM function will read multiple consecutive records into memory 
beginning at the current DMA. The r0, rl, and r2 field of the FCB will 
automatically be incremented to read each record; however, the FCB’s random 
record number is restored to the first record’s value upon return to the calling 
process. 

Upon return from the call, register A either contains an error code or the 
value 00H indicating the operation was successful, in which case the current 
DMA address contains the randomly accessed record or multiple records if 
using function 44 (see paragraph on function 34). If register A is non-zero, 
one of the following error codes will be returned: 

01 - READING UNWRITTEN DATA 

03 - CANNOT CLOSE CURRENT EXTENT 

04 - SEEK TO UNWRITTEN EXTENT 

06 - SEEK PAST PHYSICAL END OF DISK (RANDOM RECORD NUMBER 

OUT OF RANGE) 

08 - RECORD LOCKED BY ANOTHER PROCESS 

10 - FCB CHECKSUM ERROR 

11 - UNLOCKED FILE VERIFICATION ERROR 

255 - PHYSICAL ERROR (REFER TO REGISTER H) 

If a physical error is returned, register H will contain one of the following 
error codes: 

01 - PERMANENT ERROR 

04 - SELECT ERROR 
* 

NOTE: If a physical error is returned in the RANDOM READ function, the 

four MSBs of register H contain an integer set to the number of records 
successfully read before an error was encountered. Note that contrary to the 
SEQUENTIAL READ operation, the record number is not advanced; therefore, 
subsequent RANDOM READ operations continue to read the same record. 
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Upon each RANDOM READ operation, the logical extent and current record 
values are automatically set; therefore, the file can be sequentially read or 
written, starting from the position from which it was accessed randomly. 
Note, however, that in this case, the last randomly read record will be read 
again as you switch from random mode to sequential read, and the last record 
will be written again as you switch to a sequential write operation. You can, 
of course, simply advance the random record position following each random 
read or write to obtain the effect of a sequential I/O operation. 


FUN CT ION .34; W RTTE R ANDOM 


Entry Parameters: : Register C - 22H 

Registers DE - FCB Address 

Returned Value: Register A - Error Code 

Register H - Physical or Logical Error 

The WRITE RANDOM operation works in nearly the same fashion as the READ 
RANDOM call, except that data is written to the disk from the current DMA 
address. Further, if the file’s space has yet to be allocated, the function 
allocates space before writing. As in the READ RANDOM operation, the 
random record number is not advanced as a result of the write. The logical 
extent number and current record positions of the FCB are set to correspond 
with the random record being written. 

SEQUENTIAL READ or WRITE operations can commence following a RANDOM 
WRITE, with the notation that the currently addressed record is either READ 
or WRITE again as the sequential operation begins. Simply advance the 
random record position following each write to get the effect of a sequential 
write operation. Note that reading or writing the last record of an extent in 
random mode does not cause an automatic extent switch as it does in 
sequential mode. 

The error codes returned by a random write are identical to the RANDOM 
READ operation with the addition of error code 05, which indicates that a 
new extent cannot be created due to directory overflow. 

To write to a file using the WRITE RANDOM function, the calling program 
must first open the base extent (extent 0). This ensures that the FCB is 
initialized properly for subsequent random access operations. 
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The base extent may or may not contain any allocated data, however, opening 
extent 0 records the file in the directory so that it can be displayed by the 
DIR utility (if a process does not open extent 0 and allocate data to some 
other extent, the file will be invisible to the DIR utility). 

The WRITE RANDOM function will set the logical extent and current record 
positions to correspond with the random record being written, but does not 
change the random record number. Therefore, sequential read or write 
operations can follow a random write, with the current record being reread or 
rewritten as the calling process switches from random to sequential mode. 

If the BDOS Multi-Sector Count is greater than one (see function 44), the 
WRITE RANDOM function will write multiple consecutive records from memory 
beginning at the current DMA. The r0, rl, and r2 field of the FCB will 
automatically be incremented to write each record; however, the FCB’s random 
record number is restored to the first record’s value upon return to the calling 
process. Upon return, the WRITE RANDOM function will set register A to 
zero if the write operation was successful; otherwise, register A will contain 
one of the following error codes: 

02 - NO AVAILABLE DATA BLOCKS (Not returned in random mode) 

03 - CANNOT CLOSE CURRENT EXTENT 

05 - NO AVAILABLE DIRECTORY SPACE (WRITE MODE ONLY) 

06 - SEEK PAST PHYSICAL END OF DISK (RANDOM RECORD NUMBER 
OUT OF RANGE) 

08 - RECORD LOCKED BY ANOTHER PROCESS 

10 - FCB CHECKSUM ERROR 

11 - UNLOCKED FILE VERIFICATION ERROR 

255 - PHYSICAL ERROR (REFER TO REGISTER H) 

If a physical error is returned, the four LSBs of register H will contain one of 
the following error codes: 

01 - PERMANENT ERROR 

02 - READ-ONLY DISK 

03 - READ-ONLY FILE OR FILE OPEN IN READ-ONLY MODE 

04 - SELECT ERROR 

NOTE: If a physical error is returned in the RANDOM WRITE function, the 

four MSBs of register H contain an integer set to the number of records 
successfully written before an error was encountered. 


4-34 


P/N 7100-0003 


9-01-82 - Rev. A 



VECTOR 4 CP/M 
PROGRAMMER’S GUIDE 


LU2LCTIQI L J5i — C.QMP.UTE F ILE SIZE 


Entry Parameters: • Register C - 23H 

Register DE - FCB address 

Returned Value: Random Record Field Set 

Register A - Error code 

Register H - Physical or Logical Error 

When computing the size of a file, register DE will address an FCB in random 
mode format (bytes r0, rl, and r2 are present). The FCB contains an 
unambiguous filename which is used in the directory scan. Upon return, the 
random record bytes contain the ’virtual’ file size which is, in effect, the 
record address of the record following the end of the file. 

If, following a call to function 35, the high record byte ’r2’ is 01, the file 
will contain the maximum record count of 65,536. Otherwise, bytes r0 and rl 
constitute a 16-bit value (r0 is the least significant byte, as before) which is 
the file size. 

Data can be appended to an existing file by using this information to SET the 
RANDOM RECORD position before performing a series of RANDOM WRITE 
operations. 

The virtual size of a file corresponds to the physical size when the file is 
written sequentially. If, instead, the file was created in random mode and 
’holes’ exist in the allocation, the file may, in fact, contain fewer records 
than the size indicates. If, for example, only the last record of an eight 
megabyte file is written in random mode (i.e., record number 65535), the 
virtual size will be 65,536 records, although only one block of data is actually 
allocated. 

On return, register A is set to zero if the specified file was found, or 0FFH 
if the file was not found; in either case, register H is set to zero. If a 
physical error is returned, register A contains ’0FFH' and register H will 
contain one of the following error codes: 

01 - PERMANENT ERROR 
04 - SELECT ERROR 

09 - IN FILENAME OR EXTENSION FIELD 
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FUNCTION 36: SET RANDOM RECORD 


Entry Parameters: Register C - 24H 

Register DE - FCB address 

Returned Value: Random Record Field Set 

The SET RANDOM RECORD function will cause the BDOS to automatically 
produce the random record position from a file which has been read or written 
sequentially to a particular point. The function can be useful in two ways. 

First, it is often necessary to initially read and scan a sequential file to 
extract the positions of various 'key* fields. As each key is encountered, 
function 36 is called to compute the random record position for the data 
corresponding to this key. If the data unit size is 128 bytes, the resulting 
record position is placed into a table with the key for later retrieval. After 
scanning the entire file and tabularizing the keys and their record numbers, 
you can move instantly to a particular keyed record by performing a random 
read using the corresponding random record number which was saved earlier. 
The scheme is easily generalized when variable record lengths are involved 
since the program need only store the buffer-relative byte position along with 
the key and record number in order to find the exact starting position of the 
keyed data at a later time. 

Second, the use of function 36 occurs when switching from a sequential read 
or write over to random read or write. A file is sequentially accessed to a 
particular point in the file, function 36 is called which sets the record 
number, and subsequent random read and write operations continue from the 
selected point in the file. 


BZN CT LQ N 37; RESET DRIVE 


Entry Parameters: • Register C - 25H 

Registers DE - Drive Vector 

Returned Value: . Register A - 00H 

The RESET DRIVE function will allow resetting of specified drive(s). The 
passed parameter is a 16-bit vector of drives to be reset, the least significant 
bit is Drive A. If another process has a file open on the drive and if the 
drive is removable or READ-ONLY, no drives are reset. 
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Register A is 00 H if no errors occur, but if a physical or logical error is 
returned, register A is FFH and register H returns the error code. 


FUNCTION 40: WRITE RANDOM WITH ZERO FILL 


Entry Parameters: Register C - 28H 

Register DE - FCB address 

Returned Value: Register A - Error Code 

Register H - Physical or Logical Error 

The WRITE RANDOM WITH ZERO FILL function is similar to the WRITE 
RANDOM function (function 34) except that a previously unallocated data 
block is filled with zeros before the record is written. If this function has 
already been used to create a file, records accessed by a READ RANDOM 
operation that contain all zeroes will identify unwritten random record 
numbers. Unwritten random records in allocated data blocks of files created 
using the WRITE RANDOM function contain uninitialized data (see WRITE 
RANDOM FUNCTION and Appendix A for a description of returned values). 


E ffl fg n QH. .ili— XBS3LAH1) WRITE RECORD 


Entry Parameters: ■ Register C - 29H 

Register DE - FCB address 

Returned Value: Register A - Error Code 

Register H - Physical or Logical Error 

The TEST AND WRITE RECORD function will provide a means of verifying 
the current contents of a record on disk before updating it. The calling 
program must set bytes r0, rl, and r2 of the FCB addressed by register DE to 
the random record number of the record to be tested. The original version of 
the record (i.e., the record to be tested) must reside at the current DMA 
address, followed immediately by the new version of the record. The record 
size can range frdm 128 bytes to 16 times that value depending on the BDOS 
Multi-Sector Count (see function 44). 

Function 41 verifies that the first record is identical to the record on disk 
before replacing it with the new version of the record. 


Rev. A - 9-01-82 


P/N 7100-0003 


4-37 



VECTOR GRAPHIC, INC, 


If the record on disk does not match, the record on disk is not changed and 
an error code is returned to the calling program. This function is intended 
for use in situations where more than one process has Read/Write access to a 
common file. Function 41 is a logical replacement for the record Lock/Unlock 
sequence of operations because it prevents two processes from simultaneously 
updating the same record. 

On return, function 41 will set register A to zero if the function was 
successful; otherwise, register A contains one of the following error codes: i 

HI - READ MODE: READING UNWRITTEN DATA 

03 - CANNOT CLOSE CURRENT EXTENT 

04 - SEEK TO UNWRITTEN EXTENT - 

06 - SEEK PAST PHYSICAL END OF DISK (RANDOM RECORD NUMBER 
OUT OF RANGE) 

07 - RECORD DID NOT MATCH 

NOTE: This function is the only function which returns an error code of 
*07’ in register A indicating non-matching sectors. 

08 - RECORD LOCKED BY ANOTHER PROCESS 

10 - FCB CHECKSUM ERROR 

11 - UNLOCKED FILE VERIFICATION ERROR 

255 - PHYSICAL ERROR (REFER TO REGISTER H) 

If a physical or logical error is returned, the four LSBs of register H contain 
one of the following error codes: 

01 - PERMANENT ERROR 

02 - READ-ONLY DISK 

03 - READ-ONLY FILE OR FILE OPEN IN READ-ONLY MODE 

04 - SELECT ERROR 

TEST AND WRITE RECORD function also sets the four high order bits of 
register H to the number of records successfully tested or written. 


EDNCTIQN 42; LOCK RECORD 


Entry Parameters: • Register C - 2AH 

Register DE - FCB Address 

Returned Value: Register A - Error Code 

Register H - Physical Error 
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The LOCK RECORD function will lock one or more consecutive records so 
that no other program with access to the records can simultaneously lock or 
update them. This function is only supported for files open in unlocked mode. 
If it is called for a file open in Locked or Read-Only mode, no locking action 
is performed and a successful result is returned. 

The calling process passes in register DE, the address of an FCB in which the 
Random Record field is filled with the random record number of the first 
record to be locked. The number of records to be locked is determined by 
the BDOS Multi-Sector Count (see Function 44). 

The LOCK RECORD function requires that each record number to be locked 
reside in an allocated block for the file. In addition, Function 42 verifies 
that none of the records to be locked are currently locked by another process. 
Both of these tests are made before any records are locked. Each locked 
record consumes an entry in the BDOS system lock table which is shared by 
locked record and open file entries. If there is not sufficient space in the 
system lock table to lock all the specified records, or the process record lock 
limit is exceeded, the LOCK RECORD function locks no records and returns 
an error code to the calling process. 

Upon return, the LOCK RECORD function sets register A to zero if the lock 
operation was successful; otherwise, register A contains one of the following 
error codes: • 

01 - READ MODE: READING UNWRITTEN DATA 

03 - CANNOT CLOSE CURRENT EXTENT 

04 - SEEK TO UNWRITTEN EXTENT 

06 - SEEK PAST PHYSICAL END OF DISK (RANDOM RECORD NUMBER 
OUT OF RANGE) 

08 - RECORD LOCKED BY ANOTHER PROCESS 

10 - FCB CHECKSUM ERROR 

11 - UNLOCKED FILE VERIFICATION ERROR 

12 - PROCESS RECORD LOCK LIMIT EXCEEDED 

13 - ACCESSED FILE NOT PREVIOUSLY OPENED 

14 - NO ROOM IN THE SYSTEM LOCK LIST 

255 - PHYSICAL ERROR (REFER TO REGISTER H) 
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If a physical or logical error is returned, register A is 0FFH and register H 
will consists of one of the following: 

PHYSICAL ERROR CODES: (IN THE FOUR LOW-ORDER BITS OF H) 

91 - PERMANENT ERROR 
94 - SELECT ERROR 


FUNCTION 43: UNLOCK RECORD 


Entry Parameters: Register C - 2BH 

Register DE - FCB Address 

Returned Value: Register A - Error Code 

Register H - Physical Error 

The UNLOCK RECORD function will unlock one or more consecutive records 
previously locked by the LOCK RECORD function. This function is only 
supported for files open in unlocked mode. If it is called for a file open in 
Locked or Read-Only mode, no locking action is performed and a successful 
result is returned. 

The calling program passes, in register DE, the address of an FCB in which 
the Random Record field is filled with the random record number of the first 
record to be unlocked. The number of records to be unlocked is determined 
by the BDOS Multi-Sector Count (see Function 44). 

The UNLOCK RECORD function will not unlock a record that is currently 
locked by another process. However, no error is returned if a process 
attempts the process. Therefore, if the Multi-Sector Count is greater than 
one, the UNLOCK RECORD function unlocks all records locked by the calling 
program, while skipping those records locked by other programs. 

On return, the UNLOCK RECORD function sets register A to zero if the 
unlock operation was successful; otherwise, register A will contain one of the 
following error codes: 

91 - READ MODE: READING UNWRITTEN DATA 

93 - CANNOT CLOSE CURRENT EXTENT 

94 - SEEK TO UNWRITTEN EXTENT 

96 - SEEK PAST PHYSICAL END OF DISK (RANDOM RECORD NUMBER 
OUT OF RANGE) 
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19 - FCB CHECKSUM ERROR 
11 - UNLOCKED FILE VERIFICATION ERROR 
131- ACCESSED FILE NOT PREVIOUSLY OPENED 
255 - PHYSICAL ERROR (REFER TO REGISTER H) 

If a physical or logical error is returned, register A is 0FFH and register H 
consists of one of the following: 

PHYSICAL ERROR CODES: (IN THE FOUR LOW-ORDER BITS OF H) 

91 - PERMANENT ERROR 
94 - SELECT ERROR 


EUNCTIQN 44 ; SET-M U LH-SE CT Q R C OUNT 


Entry Parameters: ■ Register C - 2CH 

Register E - Number of sectors 

Returned Value: Register A - Return Code 

The SET MULTI-SECTOR COUNT function will provide logical record blocking. 
It enables a process to read and write from one to 16 ’physical’ records of 
128 bytes at a time during subsequent BDOS Read and Write functions. It 
also specifies the number of 128-byte records to be locked or unlocked by the 
BDOS LOCK and UNLOCK functions. 

Function 44 sets the Multi-Sector Count value for the calling program to the 
value passed in register E. Once set, the specified Multi-Sector Count remains 
in effect until the calling process makes another ’set count’ call and changes 
the value. Note that the CCP will set the count to one when it initiates a 
transient program. 

The Multi-Sector Count affects BDOS error reporting for the BDOS READ, 
WRITE, LOCK and UNLOCK functions. If an error interrupts these functions 
when the Multi-Sector Count is greater than one, they return the number of 
records successfully processed in the for high-order bits of register H. 

Upon return, register A is set to zero if the specified value is in the range of 
1 to 16; otherwise, register A is set to 0FFH. 
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EmCTI Q N 45 ; —SE T EPOS ERROR MOPE 


Entry Parameters: Register C - 2DH 

Register E - BDOS Error mode 

The SET BDOS ERROR MODE function will determine how physical and logical 
errors are handled for a process. The function can exist in one of three 
modes: the Default mode, the Display and Return mode, and the Return Error 

mode. 

In the Default mode, the BDOS will display a system message at the console 
identifying the error and will then terminate the calling program. 

In the Return Error mode, the BDOS will set register A to 0FFH (255 
decimal), place an error code identifying the physical or logical error in the 
four low-order bits of register H, and return to the calling program. No 
system messages are displayed, however, when the BDOS is in Return Error 
mode. 

In the Display and Return mode, the BDOS will display the error on the 
console and return the error code in the H register in the same manner as 
mode two. 

Function 45 will set the BDOS error mode for the calling program to the mode 
specified in register E. If this register is set to '0FEH', mode three (Display 
and Return)! will be set; if the register is set to T 0FFH’, mode two (Return 
Error) will be set; if set to any other value, mode one (Default) will be set. 


E UH .CTIQN. 46 ;— RE TU RN. FREE PISS SPACE 


Entry Parameters: 1 Register C - 2EH 

Register E - 00 - Drive A 

01 - Drive B 

02 - Drive C 

03 - Drive D 

<r 

Returned Value: Current DMA Buffer - Number of free records on disk 

The RETURN FREE DISK SPACE function will return the number of free 
records remaining on disk. To maintain upward compatability, use this function 
instead of counting space from allocation records. 
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The function returns a 24-bit value in the first three bytes of the current 
DMA buffer, with the low bits in the first byte, the middle bits in the second 
byte and the high bits in the third byte. 

Normally, register A is zero upon return, but if a physical or logical error is 
returned, register A is 0FFH and register H is one of the following codes: 

01 - Permanent error 
04 - Select error 


£ UNCTION.. 47: CHAIN T Q .EEQGBAM 


Entry Parameters: • Register C - 2FH 

The CHAIN TO PROGRAM function will provide a means of chaining from one 
program to the next without operator intervention. Although there is no 
passed parameter for this call, the calling program must place a command line 
terminated by a null byte in the default DMA buffer (80H). 

Function 47 does not return any values to the calling program because any 
errors encountered are handled by the CCP. 

FUNCTION 48: FLUSH BUFFERS 

Entry Parameters: : Register C - 30H 

Returned Value: Register A - Error flag 

Register H - Permanent or Logical Error 

The FLUSH BUFFERS function will force the write of any write-pending 
records contained in internal blocking/deblocking buffers. This function only 
affects those systems that have implemented a write-deferring 
blocking/deblocking algorithm in their BIOS. 

Upon return, register A is set to zero if the flush operation was successful or 
if a physical or logical error is returned, register A is 0FFH and register H is 
01 - Permanent Error. 
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FUNCTION 152s PARSE FILENAME 


Entry Parameters: Register C - 98H 

Register DE - PFCB Address 

Returned Value: Register HL - Return Code 

(Parsed File Control Block) 

The PARSE FILENAME function will parse an ASCII filename and prepare an 
FCB; the calling program will pass the address of the Parse File Control Block 
(PFCB) in register DE. The PFCB contains the address of the ASCI filename 
string followed by the address of the target FCB. Initialization of the PFCB 
data structure is shown below in assembly language: 


PFNCB: 


DW 

FLNAME 

DW 

FCB 

FLNAME: 


DS 

128 

FCB: 


DS 

36 


The file specification should be written in the following form: 
d:filename.ext 


Function 152 will parse the first file specification found in the input string, 
first eliminating leading blanks and tabs. It will then assupie the file 
specification ends on the first delimiter encountered that is out of context 
with the specific field it is parsing. 
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The specified FCB will be initialized as follows: 

BYTE DESCRIPTION 

0 Drive field set to specified drive number. If drive not 

specified, default value is used. 

0 = default 

1 = Drive A 

2 = Drive B 


16 = Drive P 

1-8 Name field set to specified filename, and all letter are 

converted to uppercase. 

Filename < 8 characters, remaining bytes in field padded with 
blanks. 

Filename > 8 characters, error message displays. 

Filename has (*) , all remaining bytes filled with (?). 

9-11 Extension field set to specified extension; if none specified, 
field is initialized to blanks (all letters converted to 
uppercase). 

Extension < 3 characters, remaining bytes padded with blanks. 
Extension has (*), all remaining bytes filled with (?). 

In case of an error, all fields not parsed will be set to their default values 
and register HL will return a 0FFFFH indicating ! the error. 

The PARSE FILENAME function, on a successful parse, will check the next 
item in the Filename string, skipping over trailing blanks and tabs and look at 
the next character. If the character is a null or a carriage return, it will 
return a 0 indicating the end of the Filename string; if the next character is 
a delimiter, it will return the address of the delimiter; if the next character 
is ool a delimiter, it will return the address of the delimiting blank or tab. 

If the first non-blank or non-tab character is a null (0) or a carriage return 
within the Filename string, function 152 will return a zero indicating the end 
of the string, and the FCB will be initialized to its default value. If 
function 152 is to be used to parse a subsequent filename in the Filename 
string, the returned address should be advanced over the delimiter before 
placing it in the PFCB. 
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E.PN.CTIQN 1 5 8; ATTACH ..LIST 


Entry Parameters: • Register C - 9EH 

Returned Value: • None 

The ATTACH LIST function will attach the previously specified list device 
assignment to the calling program. If the list device is already attached to 
another job or program, the calling program will relinquish the CPU and wait 
until the other program detaches from the list device; the attach operation 
will take place when it becomes free. See, FUNCTION 250. 


IMC3IQM.-1 5 9.S- DETACH. LIST 


Entry Parameters: Register C - 9FH 

Returned Value: None 

The DETACH LIST function will detach the previously specified list device 
assignment from the calling program. If no list device is currently attached, 
no action will take place. See FUNCTION 250. 

FUNCTION 160: SET LIST 

Entry Parameters: Register C - A0H 

Register E - List Device 

Returned Value: None 

The SET LIST function will detach the currently attached list device from the 
calling program and attach the newly specified list device. If the list device 
is already attached to another job or program, the calling program will 
relinquish the CPU and wait until the other program detaches from the list 
device; the attach operation will take place when it becomes free. The list 
device can also be set using function 8, SET IOBYTE. 
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The value of register E can be one of the following: 

E = 0 - No List Device 
E = 1 - Echo to Console 
E = 2 - Logical List Device 1 
E = 3 - Logical List Device 2* 

See FUNCTION 250. 


FUNCTION 151; CO NDITIONA L ATTACH LIST/ 

Entry Parameters: Register C - A1H 

Returned Value: : Register A - Return Code 

The CONDITIONAL ATTACH LIST function will attach the previously specified 
list device assignment to the calling program if. the list device is currently 
unattached. If the list device is currently attached to another job or program, 
a value of 0FFH in register A is returned, indicating that the list device 
could not be attached. See FUNCTION 250. 


FUNCTION 164: GET LIST NUMBER 


Entry Parameters: • Register C - A3H 

Returned Value: Register A - List Number 

Register H - Selected List Device Number 
Register L - Attached List Device Number 

The GET LIST NUMBER function will return the value of the specified list 
device assignment of the calling program. See FUNCTION 250. 
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N 217; 


■GEX/SET CO NFIG BYTE 


Entry Parameters: • 


Returned Values: 


Register D - 8-bit Mask 
Register E - 00H - SET Mode 
Register E - 01H - RESET Mode 
Register E - 02H - TOGGLE Mode 
Register E - Anything other - GET Mode 


Register A - 00H - SET, RESET, & TOGGLE Modes 
Register A - Current CONFIG BYTE (GET Mode) 


The GET/SET CONFIG BYTE function will enable or disable the [CTRL C], 
[CTRL P], and the [CTRL K] functions by setting a bit within the CONFIG 
BYTE. Any bit set in the D register mask will affect the user’s CONFIG 
BYTE according to the mode set by the value in the E register. When the 
values change within the different modes, the results will vary; e.g.: 

SEX MODE 


CCNFIG BYTE = 0010 1010 
Register D = 0000 0001 
Result = 0010 1011 




Lags 


CONFIG BYTE = 0010 1010 
Register D = 0000 0010 • 
Result = 0010 1000 


lt.ee* 


SMB 


CONFIG BYTE = 0010 1010 
Register D = 0000 0011 
Result = 0010 1001 


GE T . MODE 

The GET Mode will ignore the D register and return the CONFIG 
BYTE in’ the A register. 
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A bit set within the CONFIG BYTE will enable the associated function, while 
a bit reset within the CONFIG BYTE will disable the associated function; a 
’0’ equates to ’off’ and a ’1’ equates to ’on*. The CONFIG BYTE bits have 
been defined as follows: 

Bit 0 = [CIRL C] Warm Boot function 

0 = Disable 

1 = Enable 

Bit 1 = [CIRL P] Trap 

0 =Disable (disables printer echo enable/disable) 

1 = Enable 

Bit 2 = [CIRL K] Trap 

0 = Disable (disables printer form feed) 

1 = Enable 

Bits 3-7 = Reserved for Future Use 


ftNCTKH 218: 


I 


WltK 


(XRRHTT CERSCR POSITION 


Entry Parameters: Register C - 0EAH 

Returned Values: Register H - Current CUrsor X 

Register L - Current Cursor Y 

The RETURN CURRENT CURSOR POSITION function will return the X and Y 
values corresponding to the position of the cursor on the screen. The 
position of the cursor may be set directly by using the cursor 
positioning function in the video driver. 


EQPIQ i 222: 


Miiyjj 




Entry Parameters: Register C - 0DEH 

Register E - Tone Generator 
Register B - Attenuation 
* Register D - Time Duration 

Register HL - Frequency/Noise Control 

Returned Values: None 
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The OUTPUT TONE function will output a desired frequency of sound, for a 
specified amount of time and at a specified volume, through one of the three 
tone generators within the Vector 4. This function is also capable of 
outputting one of two different types of ’noise* (white noise and periodic 
noise) allowing user-defined frequency ranges, volume, and duration. 

The tone generator is selected from the contents of the E register, the values 
consist of the following: • 

0 = Tone Generator 1 

1 = Tone Generator 2 

2 = Tone Generator 3 

3 = White Noise Generator 

4 = Periodic Noise Generator 

The attenuation, or reduction of volume, of the tone generator is selected by 
using the value in the B register (the higher the value, the lower the volume), 
the values consist of the following: i 


0 

S 

0db 

8 = 

lSdb 

1 

= 

2db 

9 = 

18db 

2 

= 

4db 

10 = 

20db 

3i 

[ = 

6db 

11 = 

22db 

4 

= 

8db 

12 = 

24db 

5 

s 

lOdb 

13' = 

26db 

6 

=5 

12db 

14 = 

28db 

7 

2 

14db 

15i = 

OFF 


Note: Since only the low-order four bits determine the attenuation, the 

high-order bits are ignored. 

The time duration is selected by a single byte value from the D register in 
the range of 0 to 255; this range, measured in seconds, converts from l/64th 
second to 255/64 seconds. The unit of time measurement, therefore, is based 
on an interval of l/64th of a second; e.g., the value '58* equals 58/64 of a 
second. If a time of zero (0) is selected, the time for the tone generator will 
not be reset. CP/M decrements each timer every l/64th of a second; when a 
given timer reaches zero, CP/M automatically turns the appropriate tone 
generator off. 

The frequency is selected by a frequency range between 62.5 KHz to 61.0 Hz 
from the HL register (for more information on frequency settings for pitch 
control, see Appendix B). If a frequency of zero (0) is selected, the 
frequency of the tone generator remains unaltered. 
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The noise generator, either white noise (random) or periodic noise (selective 
pulse), is selected from the value of the E register; however, only one noise 
generator can be selected at a time. The frequency range of the generated 
noise can be set by using one of the modes from the following table: 

9 = No Frequency Change 

1 = Higher Frequency (3906 Hz) 

2 = Medium Frequency (1953 Hz) 

3 = Lower Pitch (976 Hz) 

4 = Use Tone Generator 3 for Pitch Control 

Use of the tone generator (4 in above table) will enable a finer control 
of frequency range, i.e., white noise or periodic noise will be more finely 
controlled around a given pitch rather than a random generation of noise. 
The mode of operation, selected from the above table, for the noise 
generator is placed into register L; however, any of the values given in 
Appendix B can be used to base the noise generator around a specific 
pitch. The volume and duration of the noise generator is controlled in 
the same manner as the tone generators. 




Entry Parameters: : Register C - 0DFH 

Returned Value: Register A - Tone Generator Status Vector 
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The RETURN TONE GENERATOR STATUS function will return to the caller 
the status of all of the three tone generators and the two noise generators. 
The bit positions of each tone and noise generator is as follows: • 


Z S_ 


JL 


x. x .... x lii-iit-i /g in i n 




1 

1 1 1 

1 

1 

1 

I 

t 

1 

1 

1 

i 

1 

I 

I | TCNE GENERATOR #1 

1 1 

| TONE GENERATOR #2 : 

1 

1 

1 

1 

1 

1 

1 

I 

1 

TONE GENERATOR #3 f 

1 

1 

1 

1 

1 

1 

1 

WHITE NOISE GENERATOR 


PERIODIC NOISE GENERATOR 


NOT USED 


A bit that is ON (1) designates that the tone/noise generator is active. 

A bit that is OFF (0) designates that the tone/noise generator is inactive. 

NOTE: The white and periodic noise generators are actually one generator; 

when the white noise generator is active, the periodic noise generator is also 
active. 


FUNC TI ON .224 : D ETECT B -Q ., .STA T US 


Entry Parameters: Register C - 0E0H 

Returned Value: Register A - 00 - R/W 

01 - R-O 

The DETECT R-0 ’STATUS function will detect if a disk is (physically) write 
protected. It returns a Boolean value in the A register. 
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FUNCTION 225; RETURN BIOS ERROR CODE 


Entry Parameters: Register C - 0E1H 

Returned Value: • Register HL - Error Code 

The RETURN BIOS ERROR CODE function will return the BIOS error code 
from the last disk access in register HL. It is used to test for errors when 
error messages are inhibited by function 226. Register H returns a BIOS code 
related to a specific BIOS error message. Register L returns a BDOS error 
code related to a specific BDOS error message. 


FUNCTION 226: INHIBIT/ENABLE BDOS ERRORS 


Entry Parameters: Register C - 0E2H 

Register E - 0FFH - Enable 
00H - Disable 

Returned Value: 

The INHIBIT/ENABLE BDOS ERRORS function will allow the programmer to 
inhibit or enable BDOS error messages. When the errors are disabled, 
function 225 should be invoked after every disk access in order to test for 
errors. At the end of execution of the program the errors should be enabled. 


FUNCTION 227: INHIBIT/ENABLE BIOS ERRORS 


Entry Parameters: - Register C - 0E3H 

Register E - 0FFH - Enable 
00H - Disable 

The INHIBIT/ENABLE BIOS ERRORS function will enable and disable BIOS soft 
errors. If enabled, BIOS soft errors are either printed on the console (if error 
reporting enabled, see function 226) or can be read from register H after a 
function 225 call. 
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FUNCTION 228; GET/SET ACCOUNT CODE 


Entry Parameters: - Register C - 0E4H 

Register E - 0FFH - Get Code 

Account Code (to set) 

Returned Value: Register A - Account Code 

The GET/SET ACCOUNT CODE function will get or set the account code. 
The account code works in a manner similar to the user number. It is used to 
coordinate auto boot commands and to secure disk files. A file is locked 
under an account code if bit 7 of the first letter of the filename is high. 
This function was designed primarily for multiuser systems. The code may be 
in the range from 00-0FH. 


FUNCTION 229: START DESPOOLER 


Entry Parameters: : Register C - 0E5H 

Register DE - FCB address 

Returned Value: Register A - Return Code 

The START DESPOOLER function will start the print despooler; a despooler 
outputs data from a disk file to a list device. The FCB addressed by 
register DE must point to an unambiguous filename. The current record of the 
FCB (FCB + 32) should contain the list device driver number, (1 or 2). If 
bit 7 of the current record (FCB + 32) is high, the despooler will use 
auto-paging. The function can return the following codes in register A: 

00H - Despooler Activated 
FFH - Despooler Busy 
FEH - Bad Filename 
FDH - File Not Found 
FCH - Illegal Print Device 
0FBH - Printer Busy 
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F U NCTION 23Q: ABOATJ3ESEQ Q LEB 


Entry Parameters: • Register C - 0E6H 

Returned Value: Register A - Return Code 

The ABORT DESPOOLER function will abort operation of the despooler. In 

the event that an FEH is returned, it means that a user has attempted to 

abort the despool process of another user. The function will return the 
following code in register A: 

00H - Despool Aborted 

FFH - Despool Not ctive 

FEH - Account Number Mismatch 


FUNCTION 231: START SPOOLER 


Entry Parameters: Register C - 0E7H 

Register DE - FCB 

Returned Value: Register A - Return Code 

The START SPOOLER function will intercept characters going to the printer 
and redirect them to a disk file. The current list device will be released if 
the spooler is successfully activated. The function will return the following 
code in register A: 

99H. - Spooler Activated 
FFH - Spooler Busy 
FEH - Destination File Exists 
FDH - No Directory Space 
FCH - Illegal Filename 


FUNCTION 232: CLOSE SPOOLER 


Entry Parameters: Register C - 0E8H 

Returned Value: Register A - Return Code 
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The CLOSE SPOOLER function will terminate the use of the print spooler. 
The spooler must be closed to assure that no file data is lost. In the event 
of a disk error (such as disk full), the spooler will terminate on its own. The 
function will return one of the following codes in register A: 

00H - Spooler Closed 
FFH - Spooler was not Active 
FEH - Disk Write During Closing 
FDH - Unable to Close File 


FUNCTION 233: RELEASE TIME SLICE 


Entry Parameters: Register C - 0E9H 

The RELEASE TIME SLICE function will release the current time slice. It 
should be incorporated in all long delay loops as it will improve the system 
efficiency. This is especially important if the program will run in a multiuser 
system. 


2mCHQM_234L. .SET- DMA. -TASK 


Entry Parameters: Register C - 0EAH 

Register E - DMA task number 

The SET DMA TASK function will set the DMA task for disk I/O. It is used 
by the operating system and should normally not be used in application 
programs. The DMA task number is passed in register E. 


FUNCTION 235: CHAIN CCP COMMAND 


Entry Parameters: Register C - 0EBH 

Register DE - Address of Command String 

* 

The CHAIN CCP COMMAND function will chain CCP commands and works 
similarly to a single line submit file. Use function 235 at the end of a 
program when you want to invoke another program. Pass the address of a 
valid CCP command string in the DE register pair. 
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The string must be terminated by a null (00H). The system will warm boot and 
the command will be executed by the CCP. 


FUNCTION 236: RETURN OUTPUT STATUS 


Entry Parameters: Register C - 0ECH 

Returned Value: Register A - 00 - Not Ready 

- 0FFH - Ready 

The RETURN OUTPUT STATUS function will return the output status, (ready 
or not ready to print), of the currently selected print device. 


FUNCTION 237: RETURN INPUT STATUS 


Entry Parameters: Register C - 0EDH 

Returned Value: Register A - 00 - No Character Present 

- 0FFH - Character Present 

The RETURN INPUT STATUS function will return the input status (character 
present or not) of the currently selected list device. 


FUNCTION 238: LIST INPUT 

Entry Parameters: Register C - 0EEH 

Returned Value: Register A - Input Character 

The LIST INPUT function will input a character from the currently selected 
list device. It is used primarily for printers that require a special 
communications protocol, or can be used with printers that have a keyboard. 
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E P NCTION-239 ; RETURN. PRINTER TYPE 


Entry Parameters: Register C - 0EFH 

Register E - 00H - Current List Device 
01H - List Device 1 
02H - List Device 2 

Returned Values: Registers HL Type Bytes (see text) 


The RETURN PRINTER TYPE function will return the type bytes for the 
currently selected printer. Register L contains Type I. byte (printer type) and 
register H contains the Type II byte (the interface byte). For a list of 
possible values see the documentation for the List Device Drivers 
(paragraph 3.3.9 - GENLIST Command). Pass a 00H, 01H or 02H in 
Register E, depending on which list device type is wanted. 


E U HCTIQN-,24 0; 


KMtt 


ALIZF. PRINTER 


Entry Parameters: Register C - 0F0H 

The INITIALIZE PRINTER function will perform any necessary initialization 
required by the currently selected print device. 


FUNCTION 241: ENABLE/DISABLE CIRCULAR BUFFERS 


Entry Parameters: Register C - 0F1H 

Register E - 0FFH - Enable 
00H - Disable 

The ENABLE/DISABLE CIRCULAR BUFFERS function will enable and disable 
the console input circular buffers, for use with a multiuser system. The 
buffers will be automatically re-enabled on a cold or warm boot. 
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FUNCTION 242: ENABLE/DISABLE KEYBOARD CONVERSIONS 


Entry Parameters: : Register C - 0F2H 

Register E - 0FFH - Enable 
00H - Disable 

The ENABLE/DISABLE KEYBOARD CONVERSIONS function will enable and 
disable the keyboard conversions normally carried out by the Monitor. The 
conversions are automatically re-enabled on a cold or warm boot. 


FU NCTION .143 s ENABLE/DISABLE AUT O P AGING 


Entry Parameters: i Register C - 0F3H 

Register E - 0FFH - Enable 
00H - Disable 

The ENABLE/DISABLE AUTO PAGING function will enable or disable the 
printer auto-paging. The function is automatically toggled along with the 
printer when the [CTRL P] function is used in function 10, READ CONSOLE 
BUFFER. It is also automatically cleared on warm or cold boot or by the 
INITIALIZE PRINTER, function 240. 


FUNCTION 244: RETURN REVISION LEVEL 


Entry Parameters: Register C - 0F4H 

Returned Value: Register H - Version Levels 

H=0 (Other Versions of CP/M) 
H=1 (Other Versions of CP/M) 
H=2 (Vector 4 CP/M) 

Register L -Revision Levels 


The RETURN REVISION LEVEL function will return the revision level of the 
current version of CP/M that is being used. The function will be used to 
determine if certain BDOS features are installed. 
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FUNCTION 245; ENABLE/DISABLE CROSS-BANK CALLS 


Entry Parameters: Register C - 0F5H 

Register E - 00 - Disable 
- 0FBH - Enable 

The ENABLE/DISABLE CROSS-BANK CALLS function will either enable or 
disable the CCP from calling the BDOS, and the BDOS frcm calling the 
BIOS, through the BDOS or BIOS Jump Tables within the user's memory. 
This feature allows the user to modify the BIOS Jump Table, or intercept 
BDOS calls, and reroute them to the user's own routines. The BDOS and 
BIOS Jump Tables may then be restored to their original form by 
initiating a cold boot sequence, or by calling this function with a zero 
in the E register. The default used by the BDOS and OOP is to not use 
the user’s vectors and jump directly tot he BDOS and BIOS respectively. 
This default is used because the system throughput is increased 
enormously when the CCP can call the BDOS, and the BDOS can call the BIOS 
directly; therefore, the program should disable the cross-bank calls upon 
termination of its task. 

Without setting the BDOS Base Address down (#246) the BIOS Jump Table 
will be refreshed on Warm Boots. 


e tc hq i ms caa c E axs. . b ass aeebbss 


Entry Parameters: i Register C - 0F6H 

Register E - Page Address 

The CHANGE BDOS BASE AEORESS function provides a means to the programmer 
to lower the base address of the BDOS. This feature is useful for 
programs that want to intercept system calls, to perform additional 
tasks, such as plotting, asychronous comnini cat ions, etc., and yet not be 
disturbed by a warm boot, or the end of execution of a program. 
Function 246 will adjust both the BDOS vector at location 5 and the 
pseudo-BDOS located at the top of the 1PA to the page address specified 
in the E register* ( i .e., E register equals 0CEH, the vector at location 5 
will change to JMP GE06H; and the pseudo-BDOS will be relocated to 
CE00H). Subsequent attempts from the BDOS to access the user’s disk I/O 
error vectors will get these vectors frcm the CE00H pseudo-BDOS. If the 
E register contains a zero, or if a cold boot sequence is initiated, the 
BDOS will return to its default location. 
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FTOIOT 247; I 


?*; k » » ; • a; 


tl CLOCK SPEED 


Entry Parameters: Register C - 0F7H 

Returned Value: • Register A - Clock Speed in MHz 

(4 = 43VHz, 5 = 5MHz, 6 = SVHz) 

The RETORN MICROPROCESSOR CLOCK SPEED function will return the clock 
speed of the microprocessor to the calling program. This can be useful 
for programs that require semiaccurate time delays, and these delays need 
to be adjusted according to the clock speed of the processor. 


HNCTICN 248: HEAD RECCED 


Entry Parameters:: Register C - 0F8H 

Register DE - Record Number 

Returned Values: Register A - Error Code 

Register H - Physical or Logical Error 

The READ ACTUAL RECORD function will read fran the currently selected 
drive one to sixteen 128-byte records starting at the record number 
passed in the E register into memory beginning at the EMA address. This 
function will allow the programmer to read all but the system tracks on a 
logical disk unit. Since the largest logical disk unit that can be 
supported by VECTOR 4 CP/M can only be 8 Mbytes in size (including the 
directory), this allows for 65,536 128-byte records. The prograimer need 
only select the appropriate drive and then read the actual record 
desired. This facility allows VECTOR 4 CP/M to retrieve information from 
non-CP/M structured diskettes. The value 00H is returned in the 
A register if the read operation was successful; otherwise, an error code 
will be returned as described in functions 20 and 33, READ SEQUENTIAL and 
RANDCM. 
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EQCTIC K 2 49; J HBm J OmL 


M 


Entry Parameters:: Register C - 0F9H 

Register DE - Record nianber 

Returned Values: Register A - Error Code 

Register H - Physical or Logical Error 

The WRITE ACTUAL RECCED function will write frcm one to sixteen 128-byte 
records, beginning at the current DMA address onto the currently selected 
disk starting at the record number passed. This funciton is the 
compliment to function 248, READ ACTUAL RECORD, and enables the 
programmer to create and maintain a non-CP/M caipatible diskette and/or 
disk. The programmer must be specially careful in the use of this 
funciton for a rnuiber of reasons. First, the actual disk directory must 
be contained within the 8 Mbyte limit; therefore, the first several 
records starting with record zero are the actual disk directory on a CP/M 
diskette. Once the directory information has been lost, there is no way 
to recover the files that were contained within the directory record. 
Second, the programmer must carefully insure that he is not writing to 
arecord that is being used by a file on that disk. Third, there is no 
need for an PCS since this function is more of a physical interface to a 
disk rather than a logical file interface. Since there is no FGB 
maintained, there is no way for VECTOR 4 CP/M to maintain any allocation 
information about records that are wirtten using this function. 

This function will return 0FFH in the A register if the write operation 
was successful; otherwise, an error code is returned as described in 
functions 21 and 34, WRITE SEQUENTIAL and RANDOM. 


gQCTICN 250: 
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Entry Parameters:- <e> = List device (same as function 160) 

Returned Values : None 

Selects desired list device for subsequent operations by functions (158, 
159, 161, 164). ’ 
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EggOOi 255: RELEASE PILE BESCQCES 


Entry Parameters: : Register C - 0FFH 

The RELEASE FILE RESOURCES function will release all open files and 
locked records used by the calling task. This function is executed 
automatically upon entry to the OCP. 


Exhibit 4-5. HX3S FtNCTICN CHART 



EINCriCN NAME 

Tvnrrn 

OUTPUT 

9 

SYSTEM RESET 

None 

None 

1 

CCNSGLE INPUT 

None 

A = Char 

2 

OCNSCLE OUTPUT 

E= Char 

None 

3 

READER INPUT 

None 

A=Char 

4 

PINCH OUTPUT 

E= Char 

None 

5 

LIST OUTPUT 

E=Char 

See Def 

6 

DIRECT OCNSCLE I/O 

See Def 

See Def 

7 

GET I/O BYTE 

None 

A = KBYTE 

8 

SET I/O BYTE 

E = I OBYIE 

See Def 

9 

PRINT STRING 

EE = Buffer 

None 

10 

READ OCNSCLE BUFFER 

DE = Buffer 

See Def 

11 

GET OCNSCLE STATUS 

None 

A = 00/FF 

12 

RETURN VERSION NUMBER 

None 

HL = Version # 

13< 

RESET DISK SYSTEM 

None 

See Def 

14 

SELECT DISK 

E=Disk Number 

See Def 

15 

OPEN FILE 

DE = PCS 

A = Dir Code 

16 

CLOSE FILE 

DE = PCS 

A = Dir Code 

17 

SEARCH PCR FIRST * 

IE = PCB 

A = Dir Code 

18 

SEARCH FOR NEXT 

None 

A = Dir Code 

19 

DELETE FILE 

DE = PCS 

A = Dir Code 

20 

READ SEQUENTIAL 

IE = PCS 

A = Err Code 

21 

WRITE SEQUENTIAL 

EE = PCS 

A = Err Code 
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22 

MAKE FILE 

DE = FOB 

A = Dir Code 

23 

RENAME FILE 

DE = FOB 

A = Dir Code 

24 

RETURN LOGIN VECTOR 

None 

HL = Login Vecl 

25 

RETURN CURRENT DISK 

None 

A = Cur Disk* 

26 

SET EMA ADDRESS 

EE = DMA 

None 

27 

GET AI331 (Alloc) 

None 

HL = Alloc 

28 

WRITE PROTECT DISK 

None 

See Def 

29 

GET R/O VECTOR 

None 

HL = R/O Vect* 

30 

SET FILE ATTRIBUTES 

DE - FOB 

See Def 

31 

GET Am (Disk Parms) 

None 

HL = DPB 

32 

SET/GET USER CODE 

See Def 

See Def 

33 

READ RANDOM 

DE = FCB 

A = Err Code 

34 

WRITE RANDOM 

EE = FOB 

A = Err Code 

35 

OCMPUEE FILE SIZE 

EE = FOB 

r0, rl, r2 

36 

SET RANDOM RECORD 

EE = FCB 

r0, rl, r2 

37 

RESET ERIVE 

DE = Drive 

A = 00H 

40 

WRITE RANDOM WITH ZERO FILL 

EE = FOB 

A = Ret Code 

41 

TEST AND WRITE RECORD 

See Def 

See Def 

44 

SET MULTI-SECTOR COUNT 

See Def 

See Def 

45 

SET BDCS ERROR MCEE 

See Def 

None 

46 

RETURN FREE DISK SPACE 

See Def 

See Def 

47 

CHAIN TO PROGRAM 

C = 2FH 

None 

48 

FLUSH BUFFERS 

See Def 

See Def 

152 

PARSE FILENAME 

See Def 

See Def 

158 

ATTACH LIST 

C = 9EH 

None 

159 

DETACH LIST 

C = 9FH 

None 

160 

SET LIST 

See Def 

See Def 

161 

CONDITIONAL ATTACH LIST 

C = A1H 

A = Ret Code 

164 

GET LIST NUMBER 

C = A3H 

A = List # 

217 

GET/ SET CONFIG BYTE 

See Def 

See Def 

218 

RETURN CURRENT CURSOR POSITION 

C = 0DAH 

HL = Cursor Pos 

219 

RESET DEFAULT CONSOLE CONVERSION 

C = 0 m 

A - Conv Table 

220 

CONVERT CODE 

See Def 

A = Converted \ 

222 

OUTPUT TONE 

See Def 

None 
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3 

RETURN TCNE GENERATCR STATUS 

C = 0DFH 

4 

DETECT R/O STATUS 

None 

5 

RETURN BIOS ERROR CODE 

None 

6 

INHIBIT/ENABLE BDOS ERRORS 

See Def 

17 

INHIBIT/ENABLE BIOS ERRORS 

See Def 

:8 

GET/ SET ACCOUNT CODE 

See Def 

!9 

START DESPCCLER 

DE = FCB 

10 

ABORT DESPCCLER 

None 

11 

START SPOOLER 

None 

12 

CLOSE SPOOLER 

None 

13 

RELEASE TIME SLICE 

None 

$4 

SET DMA TASK 

See Def 

15 

CHAIN CCP GQVMAND 

See Def 

16 

RETURN OUTPUT STATUS 

None 

17 

RETURN INPUT STATUS 

None 

18 

LIST INPUT 

See Def 

19 

RETURN PRINTER TYPE 

See Def 

10 

INITIALIZE PRINTER 

None 

41 

ENABLE/DISABLE CIRC BUFFERS 

See Def 

42 

ENABLE/DISABLE KEY CONYERS 

See Def 

43 

ENABLE/DISABLE AUTO-PAGING 

See Def 

44 

RETURN REVISION LEVEL 

O 

ii 

45 

ENABLE/DISABLE CROSS-BANK CALLS 

See Def 

46 

CHANGE BDOS BASE ADDRESS 

See Def 

47 

RETURN MICROPROCESSOR CLOCK SPEED 

C = 0F7H 

48 

READ ACTUAL RECORD 

See Def 

49 

WRITE ACTUAL RECORD 

See Def 

53 

SELECT LIST DEVICE 

See Def 

55 

RELEASE FILE RESOURCES 

None 


Note that A = L, and B = H upon return. 
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A = Status vector 

A = Boolean Value 

HL = Err Code 

None 

None 

See Def 

A = Ret Code 

A = Ret Code 

A = Ret Code 

A = Ret Code 

None 

None 

None 

A = Boolean Value 

A = Boolean Value 

See Def 

See Def 

None 

See Def 

See Def 

See Def 

HL = Rev Level 

None 

None 

A = Clock Speed 

See Def 

See Def 

See Def 

None 
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SECTION V - BIOS JUMP ROUTINES 


5.1 INTRODUCTION 

The entry points into the BIOS from the cold start loader and the BDOS are 
detailed below in Exhibit 5-1. Entry to the BIOS is accomplished through a ’jump 
vector’ located at ’BIOS’, as shown. The jump vector is a sequence of 43 jump 
instructions which send program control to the individual BIOS subroutines. 

All simple Character I/O operations are assumed to be performed in ASCII, upper 
and lower case, with high order (parity bit) set to zero. An end-of-media condition 
for an input device is given by an ASCII [CTRL Z] (1AH). Peripheral devices are 
seen by CP/M as ’logical’ devices, and are assigned to physical devices within the 
BIOS. All Character I/O operations will check the IOBYTE for the current settings 
of the specific device. 

The jump vector at ’BIOS' takes the form shown below where the individual jump 
addresses are given to the left in numeric order; - 




CHART 


BIOS 


CBOOT 

BIOS 

+3 

WBOOT 

BIOS 

+6 

CONST 

BIOS 

+9 

CONIN 

BIOS 

+12 

CONOUT 

BIOS 

+15 

LIST 

BIOS 

+18 

PUNCH 

BIOS 

+21 

READER 

BIOS 

+24 

HOME 

BIOS 

+27 

SELDSK 

BIOS 

+30 

SETTRK 

BIOS 

+33 

SETSEC 

BIOS 

+36 

SETDMA 

BIOS 

+39 

READ * 

BIOS 

+42 

WRITE 

BIOS 

+45 

LISTST 

BIOS 

+48 

SECTRAN 

BIOS 

+51 

DISKCMND 

BIOS 

+54 

DMABANKSET 


ARRIVE HERE FROM COLD START LOAD 

ARRIVE HERE FOR WARM START 

CHECK FOR CONSOLE CHAR READY 

READ CONSOLE CHARACTER IN 

WRITE CONSOLE CHARACTER OUT 

WRITE LISTING CHARACTER OUT 

WRITE CHARACTER TO PUNCH DEVICE 

READ READER DEVICE 

MOVE TO TRACK 00 ON SELECTED DISK 

SELECT DISK DRIVE 

SET TRACK NUMBER 

SET SECTOR NUMBER 

SET DMA ADDRESS 

READ SELECTED SECTOR 

WRITE SELECTED SECTOR 

RETURN LIST STATUS 

SECTOR TRANSLATE SUBROUTINE 

DISK COMMAND ENTRY 

SET DMA BANK # 
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BIOS +57 

SETIOBYTE 

{SET IOBYTE 

BIOS +60 

GETIOBYTE 

{RETURN IOBYTE 

BIOS +63 

ATTACH 

{ATTACH/DEATTACH CONSOLE TO TASK 

BIOS +66 

SLICERELEASE 

{RELEASE TIME SUCE 

BIOS +69 

TASKRELEASE 

{KILL CURRENT TASK 

BIOS +72 

CRNTASK 

; RETURN CURRENT TASK # 

BIOS +75 

TASKTABLE 

j RETURN POINTER TO TASK TABLE 

BIOS +78 

ALLOCLOCK 

;LOCK-OUT TASK SWITCHING 

BIOS +81 

ALLOCUNLOCK 

; UNLOCK TASK SWITCHING 

BIOS +84 

SOFTERROR 

{SET/RESET SOFT ERROR REPORT FLAG 

BIOS +87 

SUBNKMOV 

{MOVE MEMORY FROM ONE BANK TO ANOTHER 

BIOS +90 

SUBNKCAL 

{SETUP CROSS-BANK CALL 

BIOS +93 

USERDCOM 

{USER’S VERSION OF DISK COMMAND ENTRY 

BIOS +96 

CONFIG.SR 

{SET/RETURN CONFIGURATION BYTES 

BIOS +99 

LINSTAT 

{PRINTER INPUT STATUS 

BIOS +102 

LINCHAR 

{PRINTER INPUT CHARACTER 

BIOS +105 

LTYPE 

{RETURN PRINTER TYPE BYTES 

BIOS +108 

UNIT 

{INITIAUZE PRINTER 

BIOS +111 

HDVECTR 

{REMOVABLE MEDIA VECTOR RETURN 

BIOS +114 

E.DKYBD 

{ENABLE/DISABLE KEYBOARD CIRCULAR 



BUFFER 

BIOS +117 

E.DCONV 

{ENABLE/DISABLE MONITOR CONVERSION 

BIOS +120 

LPAGE 

{SET PRINTER PAGING BYTES 

BIOS +123 

MOVBDOS 

{MOVE BDOS BASE ADDRESS 

BIOS +126 

RBUFSYS 

{RESET DISK BUFFERS 

BIOS +129 

TASKWAIT 

{SUSPENDS TASK-UNCONDITIONAL BASIS 


Each jujnp address corresponds to a particular subroutine which performs the 
specific function. 
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5.2 CHARACTER I/O 

CONSOLE 

This is the principal interactive device which communicates with the operator, 

T.TST 


This is the principal listing device, one of two with VECTOR 4 CP/M, 
accessed through LIST, LISTST, LINSTAT, LINCHAR, LTYPE, LINIT, and 
LPAGE, such as a printer. 

PUNCH 

This is the principal tape punching device, if it exists, and is normally a 
high-speed paper punch or Teletype. 

READER 

This is the principal tape reading device, such as a simple optical reader or 
Teletype. 

If no peripheral device is assigned as the LIST, PUNCH, or READER device, the 
input devices will return no input and the output devices will ignore output 
characters. 


5, 3 DISK I/Q 

Disk I/O is always performed through a sequence of calls on the various disk access 
subroutines which set up the unit number to access, the track and sector on a 
paticular disk, the Direct Memory Address (DMA) address, and the DMA task 
involved in the I/O operation. After all these parameters have been set, a call is 
made to the READ or WRITE function to perform the actual I/O operation. Note 
that there is often a single call to SELDSK to select a disk drive, followed by a 
number of read or write operations to the selected disk before selecting another 
drive for subsequent operations. Similarly, there may be a single call to set the 
DMA address and DMA task, followed by several calls which read or write to/from 
the selected DMA address and task before the DMA address and task is changed. 
The sector subroutine should always be called before the READ or WRITE 
operations are performed. 
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Note that the READ and WRITE routines do perform several retries (3 reselections 
of the disk times 4 restores of the disk times 5 step-offs/ons consisting of a total 
of 72 retries) before reporting the error condition to the BDOS. If the error 
condition is returned to the BDOS, it will report the error to the user. 


5.4 BIOS JUMP CALLS 


BIOSINTT - BIOS Initialization 

This subroutine will receive control from the Initial Program Loader OPL) and is 
responsible for basic system initialization to the* default values. The common RAM 
routines are moved into common RAM for use. The Z-80’s interrupt system is set 
to ’mode 2’ and initialized. The microprocessor clock speed is determined, set, and 
recorded for system use. The BIOS disk system is configured for the number of 
physical and logical drives, and all BIOS disk buffers are then cleared and 
initialized. The BIOS begins the initialization of the CCP, BDOS, and despooler. 
Control is transferred to the BIOS cold boot entry. 


CBOOT - Cold Boot 

This subroutine is responsible for placing copies of the BIOS Jump Table (0F800H), 
BDOS Cross Bank Jump (0DD00H), the Page Zero Jump Vectors to the BIOS and 
BDOS, and DPHs into the user's bank. All stacks for this user are reinitialized and 
control is then transferred to the CCP’s Cold Boot entry address (the C register 
contains the unit number of the current drive to use; i.e., 0 = Drive A, 
1 = Drive B, ..., 15 = Drive P). 


WB.QQT - Warm Boot 

This subroutine will receive control when a warm start occurs. A warm start is 
performed whenever a user program branches to location 0000H. System parameters 
must be initialized as shown in the following Low RAM jumps: 

location 0,1,2 Set to JMP WBOOT for warm starts (0000Hs JMP BIOS +3) 

location 3 Set initial value of IOBYTE to default values, which is 

implemented in the BIOS 

location 4 ’ Set high-order nybl to current user number; set low-order nybl 
to current drive number (each nybl consists of values 0-15 
decimal) 
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location 5,6,7 Set to JMP BDOS, which is the primary entry point to CP/M 
for transient programs (0005H: JMP 3ED06H) 

The buffers for all removable media are flushed and cleared, and, after entry into 
the CCP, register C is set to the drive to select after system initialization. If the 
BDOS has not been moved by the BIOS +123 call, the BIOS will then move the 
user’s copy of the BDOS Jump Table and the Low RAM jumps into the user’s bank 
of memory. Control is then transferred to the CCP +3 with the C register set to 
the drive to select. 


C.QMST-=-.Coi]sole Status 

The Console Status routine will return the status of the input port. 

Passed: N/A 

Returned: A = 0FFH if character is present 

= 0 if no character present 

Side effect: If the console has been defined by the IOBYTE to be background 

null, then the status returned is always a null (no character 
present); if the status is background suspend, the task is suspended 
until the console has been reattached. 


CONIN - Console Input 

The Console Input routine will wait for a character to become available and then 

return with the character in the Accumulator. 

Passed: N/A 

Returned: A = Character received « 

Side effect: If the console has been defined by the IOBYTE to be background 

null, then the character returned is always a null; if the status is 
background suspend, the task is suspended until the console has been 
reattached. 
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CON OUT - Console Output 

The Console Output routine will output a character to the screen using the video 
drivers (Paragraph 5.6). 

Passed: C = Character to display 

Returned: None 

Side effects: This routine makes use of the IOBYTE for the specific task that is 

doing the call. Therefore, the character may also be printed if the 
IOBYTE specifies echo to printer; also the task may be suspended 
until the console is reattached. If the console has been defined by 
the IOBYTE to be background null, then the character is ignored. 


TJST - Print Character 

The Print character routine sends the character passed to the list device specified 
by the IOBYTE for the current task. 

C = Character to print 

None 

This routine uses the IOBYTE for the current task, so the character 
may be sent to the console, printer 1, or printer 2, or it may simply 
be thrown away. If the character is sent to the console and the 
task does not have a console then the task will be suspended until a 
console is attached to the task. 


PUNCH - Punch character 

The Punch Character routine sends the character passed to the punch device 
(Port 4). 

Passed: C = Character to punch 

Returned: None 

Side effects: Same as LIST 


Passed: 
Returned: - 
Side effects: 
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READER - Get a character from the Reader 

The Reader routine waits for a character to become available from the reader 
(Port 4) and returns it to the calling program. 

Passed: None 

Returned: A = Character received 

Side effects: If the input is from the reader, bit 7 is stripped off. 

HOME - H ome unit to track zero 

The Home routine simply moves the currently selected unit to track zero. 

Passed: None 

Returned: A - Error code returned from physical driver. 

Side effects: None 

SELDSK - Select current Disk 

The Select Disk routine selects the specified unit for future disk operations. 

Passed: C = Unit number (0 - 15, corresponding to Drives A - P) 

Returned: DE = Pointer to the system’s copy of the disk parameter header for 

the selected unit. 

HL = Pointer to the user’s copy of the disk parameter header for 
the selected unit. 

Side effects: If there is an attempt to select a nonexistent unit, the HL and DE 

registers are returned with zero as an error indicator. 
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SETTRK - Set current Track 

The Set Track routine sets the current track value for the currently selected unit 
for future disk operations. 

Passed: BC= Physical track number 

Returned: None 

Side effects: None 

SETSEC. - Set current Sector 

The Set Sector routine sets the current sector value for the currently selected unit 
for future disk operations. 

Passed: C = Logical sector number 

Returned: None 

Side effects: None 

SETDMA - Set current DMA address 

The Set DMA address routine sets the starting address of the 128-byte record for 
future disk reads and writes. 

Passed: BC = DMA address 

Returned: None 

Side effects: None 
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The Read routine reads a logical record in from the currently selected unit, track, 
and sector. The record is then placed at the starting address specified by the 
DMA address and task. 


Passed: C = 0 - Normal read 

= 1 - Directory read (buffered) 

B = 0 - Sequential read 
= 0FF - Random read 

Returned: ■ A - Error code returned from physical driver. 


Side effects: None 


WRITE - Write logical rsccnL-lo disk 

The Write routine retrieves a 128-byte logical record, pointed to by the DMA 
address and from the DMA task, and writes it out to the currently selected unit, 
track, and sector. 

Passed: C = 0 - Allocated write 

= 1 - Directory write 
= 2 - Unallocated write 

Returned: A - Error code returned from physical driver. 

Side Effects: The actual write may not be performed immediately, therefore, the 

error code may be postponed until a future read, write, warm boot, 
or reset buffer system call is made. 
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LISTST ~ List Output Status 

The List Output Status routine returns the output status of the list device. 

Passed: None 

Returned: A - FF (ready for next character) 

- 0 (printer not ready) 

Side Effects: See IOBYTE 

SECTRAN - Sector Translation 

The Sector Translation routine converts logical sector numbers into physical sector 
numbers to be passed to the SET SECTOR routine. 

Passed: BC - Logical sector number 

Returned: HL - Physical sector number 

Side Effects: i None 

DISKCMND - Disk Command 

The Disk Command routine will save the state of the interrupt system prior to 
entering the physical disk drivers and re-establishes the interrupt system to its 
original state upon return. Note: this is the main entry into the physical disk 

drivers. 

Passed: IX - Pointer to Device Control Block (DCB) 

Returned: A - Physical disk driver error code 

Side Effects: None 


5-10 


P/N 7100-0003 


9-01-82 - Rev. A 




VECTOR 4 CP/M 
PROGRAMMER'S GUIDE 


DMATASKSET - Set DMA Task 

The DMATASKSET routine will set the current DMA task number used by the disk 
system for future disk operations. 

Passed: C - Task number 

Returned: None 

Side Effects: This routine is automatically called by the CCP before control is 

passed to a transient program; therefore, there is no need for the 
user to set the DMA Task to the current task. 


SETTOBYTE - Set IOBYTE 

The Set IOBYTE routine will set the user’s current IOBYTE to the specified passed 
value. 


Passed: ■ C - IOBYTE value to be set 

Returned: -■ A - 0 (IOBYTE successfully set) 

- FF (IOBYTE not successfully set) 

Side Effects: Since the IOBYTE is a reflection of shared system resources, if a 

specific resource has already been reserved by another user, this 
routine will not set the IOBYTE and will return an error of ’FF*. 
If the IOBYTE is successfully set, the user’s IOBYTE at location 3 
is updated to the value passed. 


GE T IQBY T E - Get IO B YTE 

The Get IOBYTE routine will return the task’s current IOBYTE setting. 
Passed: None 

Returned: A - IOBYTE 

Side Effects: None 
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ATTACH - Attaeh/Detach console from task 

The ATTACH routine will either attach or detach a specific console to or from the 
current task. 


SUCERELEASE - Release remaining Time Slice 

The SUCERELEASE routine will release the remaining time allocated to the current 
task to the next task to be executed. 

Passed: None 

Returned: None 

Side Effects: The next task will receive the rest of the remaining time given up 

by the current task in addition to its normal time allocation. 

TASKRELEASE - Put current task to sleep 

The TASKRELEASE routine will put the specified current task to sleep which can 
be awakened later by an outside source, if necessary. 

Passed: C = 0 - Current Task 

=1-8 - Task 1-8 

Returned: None 

Side Effects: The system response time will increase because the sleeping task is 

no longer receiving a time slice. 
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CRNTTASK - Return Current Task Number 

The CRNTASK routine will return the number and the bank of the currently 
executing user task. 

Passed: None 

Returned: A - Task number 

E - Bank number 

Side Effects: None 

TASKTABLE - Returns Task Table Pointer 

The TASKTABLE routine will calculate the address of the BIOS Task Control Block 
(BTCB) for a specific task. 

Passed: C - Task number 

Returned: HL - Pointer to the BTCB in the system bank 

Side Effects: i None 

ALLQCLOCR - Lockout Task Reallocation 

The ALLOCLOCK routine will perform a system-wide lockout of the possible 
bank-switching movement of a current user while the system is fulfilling that user’s 
processing request. 

Passed: None 

Returned: None 

Side Effects: None 


Rev. A - 9-01-82 


P/N 7100-0003 


5-13 ( 



VECTOR GRAPHIC, INC. 


ALLOC UNLOCK - Unlock Task Reallocation 

The ALLOCUNLOCK routine will unlock the system-wide bank-switching movement 
of the current user's task. 

Passed: • None 

Returned: None 

Side Effects: Since the lockout is an incremental type lock (i.e., more than one 

user may perform a lockout at any one time), the actual unlocking 
of the system will not occur until: the lock is returned to zero (until 
all users have unlocked the system). 


SOFTERROR - Set/Reset Soft Error Report Flag 

The SOFTERROR routine will enable or disable the reporting of sectors that have 
been successfully corrected by the Error Correction Code (ECC) routines. Whenever 
a sector has been successfully corrected, the message ’SOFT ERROR- ’ will display 
at the user's console. 

Passed:- C - 0 (disable reporting) 

- FF (enable reporting) 

Returned: None 

Side Effects: None 


SflBNSM QV - Se t Up., Bank. Mq yc 

The SUBNKMOV routine will move 0 to 128 bytes of data from one specific task to 
another. 

Passed: A - Number of bytes to move (1-128) 

B - Destination task number 
C - Source task number 
DE - Destination starting address 
HL - Source starting address 

Returned: None 

Side Effects: None 
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SUBNKCAL - Set Up Bank Call 

The SUBNKCAL routine will call a specified (sub)routine in another task, and return 
control to the calling program upon completion. 

Passed: : A - Destination task number 

HL - Subroutine address 

Returned: None 

Side Effects: All registers are preserved on both the call and the return from the 

subroutine. 


USERDCOM - User's Disk Command Entry 

The USERDCOM routine will perform the same function as the DESKCMND function 
except that it will transfer the user's DCB into the system bank and either get or 
return the user's buffer. 

Passed: IX - Pointer to DCB 

Returned: A - Physical Driver Error Code 

Side Effects: None 


CONFIGtSR - ConfigurattoQ Set/Retum 

The CONFIG. SR routine will either set or return the current system configuration 
variables (see BIOS Configuration Block for a complete description of the system 
configuration variables). 

Passed: C - 0 = Return Variables 

- FF = Set Variables 

DE - Pointer to Configuration Block buffer 
Returned: -I None 

Side Effects: Any changes made to the configuration block will be in effect upon 

completion of the set call. 
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UNSTAT - List Device Input Status 

The LINSTAT routine will return the appropriate list device input status. 

Passed: None 

Returned: A - 0 = Character Not Ready 

- FF = Character Waiting 

Side Effects: See IOBYTE 

LINCHAR - List Device Input Character 

The LINCHAR routine will return a character received from the list device. 

Passed: None 

Returned: A - Character Received 

Side Effects: The input status is not checked prior to acquisition of the 

character; it is therefore up to the user to ensure that a character 
is available before calling this routine (see IOBYTE). 

LTYPE- Return List Device Type 

The LTYPE routine will return the specific list device type byte. 

Passed: C - 0 = Return currently selected list device type byte 

- 1 = Return type bytes of list device #1 

- 2 = Return type bytes of list device #2 

Returned: HL - Type bytes 

Side Effects: See LIST DEVICES 
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UNIT - Initialize List Device 

The UNIT routine will call the Initialization routine of the currently selected list 
device. 

Passed: None 

Returned: Currently None 

Side Effects: The current list devices return no values; however, since the user 

may write his own list device drivers, it is possible that values may 
be returned through the registers. 


HDVECTR. -Return Removable Media Vector 

The HDVECTR routine will return a one word, bit oriented vector containing 
information on which drives are removable media drives (i.e., floppy drives). Bit 0 
of the word corresponds to Drive A, bit 15 corresponds to Drive P. 

Passed: None 

Returned: HL - Unit Vector 

Bit 0 = Drive A, ..., Bit 15 = Drive P 
0 = Fixed Media, 1 = Removable Media 

Side Effects: None 


E^>£YBD - Enable/Disable Keyboard Circular Buffering 

The E.DKYBD routine will either enable or disable the circular buffering of 
characters received from the keyboard for the current user. 


Passed: • 


Returned: 


C - 0 = Disable Buffering 
- FF = Enable Buffering 

None 


Side Effects: When the circular buffer is disabled, all characters in the buffer are 

lost. 
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E t DCQNY - Enable/Disabls Keyboard Chaacter Conversion by., the. Monitor 

The E.DCONV routine will either enable or disable the conversion of characters 
received from the keyboard by the Monitor. 

Passed:^ C - 0 = Disable Conversion 

- FF = Enable Conversion 

Returned: None 

Side Effects: None 

LPAGE - Set List Device Auto-Paging Flag 

The LPAGE routine will set the currently selected list device's auto-paging flag 
with the value passed in the C, register. 

Passed: C - Auto-Paging Value 

Returned: None 

Side Effects: None 

MOVBDOS - Move BDOS Base Address 

The MOVBDOS routine will move the BDOS base address to any specified page 
location in the current user’s RAM whenever a warm or cold boot is performed. 

Passed: BC - Page Address 

0 = Default Value (0DEH) 

Returned: None 

Side Effects: On either a warm or cold boot, the BDOS entry jump at location 5 

and the user's copy of the BDOS are updated to reflect the 
specified 'location. 
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RBUFSYS ~ Reset Bu ffer System 

The RBUFSYS routine will flush and reset any buffers being maintained for the unit 
specified. This includes the writing of the WRITE buffers and the resetting of 
either the directory or data buffers associated with the unit. 

Passed: BC - Unit Vector: 

Bit 0 = Drive A, ... Bit 15 = Drive P 
1 = Reset, 0 = No Reset 

Returned: A - Physical Driver Error Code h 


TASKWAIT - Place Task into a Wait State 

The Task wait routine will place a specified task into a wait state until a specified 
condition occurs. This routine is useful in improving system resopnse time when 
waiting for a condition to occur. 

Passed: C - Task Number 

0 = Current task 

1 = Despooler 

2 = User 1 

3 = User 2 


B - Wait Expression 

0 = Byte Constant 

1 = Word Constant 

2 = Not Byte 

3 = Not Word 

4 = Bit 0 to become Reset 

5 = Bit 1 to become constant 


11 = Bit 7 to become Reset 

12 = Bit 0 to become set 

13 = Bit 1 to become set 


19 = Bit 7 to become set 
DE - Wait Expression Equality (WEE) 
HL - Wait Expression Address (WEA) 
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In order to use this routine the user must specify the task number to place into a 
wait state and the type of wait state expression, i.e. wait for a byte/or word at 
the WEA to equal the WEE, or a bit ia at the WEA to become set on Reset. If 
the task number is the current task, execution will resume once the wait condition 
has been met at the instruction immediately after the call to this routine. 


5.5 CP/M TABLES AND VARIABLES 


5.5J Reserved Locations in Page Zero 

Main memory, page zero, between locations 00H and 0FFH contains various segments 
of code and data which are used during processing. This information is set up for 
normal operation under VECTOR 4 CP/M, but can be overwritten by a transient 
program if the BDOS facilities are not required by the transient. For example, if a 
particular program performs only simple I/O. and must begin execution at location 0, 
it can be first loaded into the TPA using a small memory move program which will 
get control when loaded (the ’move 1 program must get control from location 0100H, 
the assumed beginning of all transient programs). The move program will then 
proceed to move the entire memory image down to location 0 and pass control to 
the starting address of the memory load. If the BIOS is overwritten, the 
programmer must bring the system back into memory with a warm boot sequence. 
The code and data areas for main memory are shown for reference in the following: 


9999E - 9992a 

9992a - 9992a 
9994H - 9994a 


9992a - 9997a 


Contains a jump instruction to the warm boot entry point at 
location F803H to allow a simple programmed restart. 

Contains the Vector standard IOBYTE. 

Contains the current default drive number and user number; the 
high nybl equates to the user number, the low nybl equates to 
the drive code (User numbers: 0 to 15, Drives: 0 = A,..., 

15 = P). 

Contains a dual-purpose jump instruction to the BDOS: 
JMP 0005H provides the primary entry point to the BDOS, and 
LHLD 0006H brings the address field of the instruction to the 
HL'register pair; this value is the lowest address in memory 
used by CP/M. NOTE: the DDT program will change the 

address field to reflect the reduced memory size in debug 
mode. 


008H - 9927H 


Restart locations 1 through 4 not currently used. 


5-20 - 


P/N 7100-0003 


9-01-82 - Rev. A 



VECTOR 4 CP/M 
PROGRAMMER’S GUIDE 


0030H - 0037H Restart location 6 not currently used. 

9038H - 003AH Contains restart 7, a jump instruction into the DDT or RAID 

program when running in debug mode for programmed 
breakpoints; however, it is not used by CP/M for any other 
reason. 


003BH - M5BH 
W5CH - 997CH 

W7DH - JT07FH 
0080H - 00FFH 


Not currently used - reserved. 

Contains the default FCB produced for a transient program by 
the CCP. 

Contains the optional default random record position. 

Contains the default 128-byte disk buffer; also filled with the 
command line when a transient is loaded under the CCP. 


5« 5 «2. , IOBYTS 

VECTOR 4 CP/M has an implementation of the IOBYTE (VECTOR 4 CP/M does not 
used Intel standard) which defines the logical to physical device mapping for 
Character I/O devices which is in effect at a particular time for an individual user. 
The mapping is performed by splitting the IOBYTE into four distinct fields of two 
bits each, called the CONSOLE, READER, PUNCH, and LIST fields, as shown 
below: 


ICBYIE at 0003H 


Most Significant 

list poor 


Least, Si gulf i caul 


healer 




uE 


bits 6,7 bits 4,5 bits 2,3 bits 0,1 


The value in each field (the definitions of which have been changed from the 
standard Intel definitions) can be in the range 0-3, defining the assigned source or 
destination of each logical device. The values which can be assigned to each field 
are given as follows: • 

CONSOLE field (bits 0.1) 

0 - Console is assigned to the console device 

1 - Console output is echoed to the print device 

2 - No console - bit bucket 

3 - No console - suspend until console available 
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MODE 

g ] 2 1 < 


ROUTINE 


CONST Normal Normal „ Not Ready 

Returns status See Mode 0 = 00H 

in A. 

Ready = 0FFH 
Not Ready = 00H 


Program is suspend 
until console is 
attached to prog 
operation eontin 
as Normal. 


CQtm Normal 

Character 
returned in A 


Normal No Character Sane as above 

See Mode 0 (Null) 00H 


CUsOUl' Normal Normal Character Seme as above 

Character placed See Mode 0 Discarded 
onto screen 


BSADEB field, (bits 2,3) 

0 - No READER 

1 - READER input from console 

2 - User defined reader #1 

3 - User defined reader #2 


* HEA3TFR 

HXE No character See CCNSCLE Normal Same as Mode 

(Null) 00H ’CCNIN’ Character 

returned in A 
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PU NC H, field (bits 4,5? 

9 - No PUNCH 

1 - PUNCH is assigned to console 

2 - PUNCH is assigned to list device 

3 - User defined punch 




a 


ME Character 

Discarded 


See CCNSCLE See LIST 

' dNCUT ’ ’LIST* 


Normal 
Character 
returned in A. 
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LIST field (bits 6.7) 

9 - No LIST 

1 - LIST is assigned to console 

2 - LIST is list device #1 

3 - LIST is list device #2 


LIST 


MTU 

0 

1 

2 

3 

LIST 

Character 

See CCNSCLE 

Normal 

Normal 


discarded 

’OCNOn” 

Character printed on prints 

LISTST 

Not ready 

Always ready 

Normal 

Normal 


00H 

0FFH 

Output status of printer 1 
returned in register A 

LINCBAR 

No character 

See CONSOLE 

Normal 

Normal 


(Null) 00H 

’CONIN’ 

Character 

Character 




received from 

received f 




printer 1 in A 

printer 2 

UNSEAT 

Not ready 

See CCNSCLE 

Normal 

Normal 


00H 

’CCNST’ 

Input status 

Input stat 




of printer 1 

of printer 




returned in A 

returned i 

LTZPE 

No printer 

See Mode 9 

Normal 

Normal 


HL = 0 


Returns type 

Returns tj 




byte in HL of 

byte in HL 




printer 1 

printer 2 

LPAG& 

No action 

No action 

Normal 

Normal 




Sets page byte 

Sets page 




for printer 1 

for prints 

LINIT 

No action 

No action 

Normal 

Normal 




Printer 1 

Printer 2 




initialized 

initialize 
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If the console output is to be echoed to the list device, and the list device 
is set to be routed to the console, an endless loop does not occur. The BIOS 
will always prevent this kind of endless loop condition from occurring, and 
will send the character to each device only once. The ICBYTE value must be 
changed through BDOS functions 7 and 8 , otherwise, the system will not 
recognize the user’s modification of the ICBYIE. 

The VECTOR 4 CP/M defaults for the ICBYIE are set at 0 and correspond to the 
following: 

• Normal console 

• No LIST 

• No HEADER 

• No PINCH 


5.5.3 Disk Parame ter Tables 

Tables are included in the BIOS which describe the particular characteristics 
of the disk subsystem used with VECTOR 4 CP/M. These tables are automatically 
generated by the GENSYS and CONFIG programs. Each disk drive has an 
associated, 18-byte Disk Parameter Header (E3PH) , which contains information 
about the disk drive and provides a 'scratchpad* area for certain BDOS 
operations. The format of each 18-byte DPH element for each drive is shown in 
the following: ■ 


XLT | 9999 1 9999 I 9999 I DERBCF | EPB | CSV i EftLY i SALV 


XLT 


9999 

DERBCF 


Address of the logical to physical translation vector, if 
used for this particular drive, or the value ’0000H’ if no 
sector translation takes place; i.e., the physical and 
logical sector numbers are the same. Disk drives with 
identical sector skew factors share the same translate 
tables. 

Scratchpad values for use within the BDOS; initial value 
is not important. 

Address of a 128-byte scratchpad area for directory 
operations within BDOS; all DPHs address the same 
scratchpad area. 
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EPB 


CSV 

EALV 


SALV 


Address of a Disk Parameter Block (DPB) for this 
particular drive; drives with identical disk 
characteristics address the same disk parameter block. 

Address of a scratchpad area used for software check for 
changed disks; this address is different for each DPH. 

Address of a scratchpad area in the user's bank used by 
the BDGS to keep disk storage allocation information; this 
address is different for each DPH. 

Address of a scratchpad area in the system bank used by 
the EDOS to keep disk storage allocation information; ! this 
address is different for each DPH. 


Given 16 disk drives, the DIHs are arranged in a table where the first row of 
16 bytes corresponds to Drive 0 (Drive A), with the last row corresponding to 
Drive 15 (Drive P). The table therefore appears as: 


DPBASE (EPH Base Address) 


1 

91 J 




BEf!E 1 

ijggjlWH t'-mi 

im 


nrarn 

iRiwni 

WWWWMt 

92 J 

XLT 02 1 

0000 I 

0000 I 

L0000_„ 

1 DIRBUF ! 

EPB 02 

1 CSV 02 

! ALV 02 1 

• 

• 

15 I 

XLT 15 1 

0000 1 

0606 1 

1 0606 

1 DIREUF 1 

DBP 15 

1 CSV 15 

! ALV 15 1. 

The SELDSK subroutine has 

the responsibility to 

return 

the base 

address of 


DPH for the selected drive. The translation vectors (XLT 00 through XLT 15) 
are located elsewhere in the BIOS and correspond one-to-one with the logical 
sector numbers zero through 15. The DPB for each drive is more complex; a 
particular DPB addressed by one or more DPHs takes the general form (each is a 
byte (8b) or word value (16b)) as shown in the following: i 


1 spt lbsh L mia urn. I mu I al l i m lo ss I of f l e seu . 

-life 2b 2 bl 2b l£b 12b 2b 2b 12 b , . ISb 2b. 


SPT Corresponds to the total number of logical sectors per track. 
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BSH Corresponds to the data allocation block shift factor; 

determined by the data block allocation size. 

EXM Corresponds to the extent mask; determined by the data block 

allocation size and the number of disk blocks. 


DSM 


Determines the total storage capacity of the disk drive (in 
blocks). 


DRM 

ALP, AL1 

CES 

OFF 

PSPT 


Determines the total number of directory entries which can be 
stored on this drive minus 1. 

Determine reserved directory blocks. 

Corresponds to the size of the directory check vector. 

Corresponds to the number of reserved tracks at the beginning 
of the logical disk. 

Corresponds to the number of physical sectors per track. 


The values of BSH and BLM implicitly determine the data allocation size BLS, 
which is not an entry in the disk parameter block. For example, if the selected 
value for the BLS is given as shown below, the values of BSH and BLM can then 
be determined (all values are in decimal): 


BLS 

J25B 

ELM 


1,024 

3 

7 


2,048 

4 

15 1 


4,096 

5 

31 


8,192 

6 

63 


16,384 

7 

127 


The value of 

EXM depends upon both 

the BLS and whether 

than 256 or greater than 255, 

as shown 

in the following: • 

RTS 

Jm < 256 


BSW > 255 

1,024 

' 0 


N/A 

2,048 

1 


0 

4,096 

3 


1 

8,192 

7 


3 

16,384 

15 


7 
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The value of the DSM is the maximum data block number supported by this 
particular drive, measured in BLS units. The product of 'BLSCDSM+l)' is the total 
number of bytes held by the drive; this must be within the capacity of the physical 
drive not counting the reserved operating system tracks. 

The DRM entry is one less than the total number of directory entries, which can 
take on a 16-bit value; however, the values of AL0 and AL1 are determined by the 
DRM. The two values, AL0 and AL1, can together be considered a string of 16 
bits, as shown in the following: 

ALSL I AL1 

I 06 I 01 1 02 I 03 I 04 I 05 I 06 I 07 1 08 I 0_9_ I 10 I 11 I 12 1 13 I 14 1 IS 


Position 00 corresponds to the high-order bit of the byte labeled AL0, and 
position 15 corresponds to the low-order bit of the byte labeled AL1. Each bit 
position reserves a data block for a number of directory entries, thereby allowing a 
total of 16 data blocks to be assigned for directory entries (bits are assigned 
beginning with *00’ and filled in to the right until position 15). Each directory 
entry occupies 32 bytes, which results in the following table: 


ms 


Directory Entries 


1,024 

2,048 

4,096 

8,192 

16,384 


32(# of bits) 
64(# of bits) 
128(# of bits) 
256 (# of bits) 
512(# of bits) 


Therefore, if DEM = 127 (128 directory entries) and BLS = 1024, there are 32 
directory entries per block, requiring four reserved blocks; Ihere, the four 
high-order bits of AL0 are set, resulting in the he values AL0 = 0F0H and 
AL1 = 00H. 


To determine the CKS value, if the disk drive media is removable, then 

CKS = (DBM+D/4, where EKM is the last directory entry nunber; if the media is 

fixed, then CKS = 0 (no directory records are checked in this case). 

♦ 

The OFF field determines the number of tracks which are skipped at the 
beginning of the physical disk. This value is automatically added whenever 
SETTRK is called, and can be used as a mechanism for skipping reserved i 
operating system tracks, or for partitioning a large disk into smaller 
segmented sections. 
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Several EPHs can address the same DPB if their drive characteristics are 
identical; furthermore, the DPB can be dynamically changed when a new drive is 
addressed by changing the pointer in the DPH since the EDOS copies the DPB 
values to a local area whenever the SELD SK function is called. Note that the 
three address values CSV, UALV, and SALV remain when returning back to the DPH 
for a particular drive. Both addresses reference an area of uninitialized 
memory following the BIOS. The areas must be unique for each drive, and the 
size of each area is determined by the values in the DPB. 

The size of the area addressed by the CSV is CXS bytes; !this is sufficient to 
hold the directory check information for this particular drive. If 
CHS = (CEM+D/4, then (DBM+l)/4 bytes just be reserved for directory check 
use; if CHS = 0, no storage is reserved. 

The size of the area addressed by UALV and SALV is determined by the maximum 
number of data blocks allowed for this particular disk and is computed as 
(DSM/8)+l. The UALV and SALV values should never be changed by any program. 

5.6 VTrmmiVKR 

The VECTOR 4 CP/M contains a powerful video driver, it’s purpose being to 
accept a stream of ASCII codes and to write them into the screen memory in the 
proper place, interpreting certain non-printing [control codes in a special 
way. Access to the video driver can be obtained in several ways; a BIOS 
console output call or BDOS direct console I/O call, function 6, with the 
control or ASCII. character in the appropriate register will send the character 
directly to the video driver within CP/M. 

The video driver has been modified to sound the speaker contained in the 
Vector 4. The bell code (07H) will be trapped by the video driver and EDCS 
function 222 will be called to produce a 750 Hz tone for 1/4 of a second 
period. If a longer bell is required, repeated bell codes (output using the 
video driver) will cause the timer to be reset. 
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The following control codes are interpreted as special functions, while all 
others are ignored: 


DECIMAL HEX 

CONTROL 

acce 

VALDE 

VALUE 


DESCRIPTION 

2 

2 

[CTRL B] 

HCME CURSOR 

4 

4 

[CTRL D] 

CLEAR SCREEN AND HCME CURSOR 

5 

5 

[CTRL E] 

DISPLAY OCDE IN B REGISTER 

7 

7 

[CTRL G] 

RFT.T. 

8 

8 

[CTRL H] 

EESTRDCTTVE BACKSPACE 




. (BACKSPACE KEY) 

9 

9 

[CTRL I] 

TAB ID NEXT 8 MULTIPLE 




(TAB KEY) 

10 

A 

[CTRL J] 

LINEFEED ([LF] KEY) 

13 

D 

[CTRL M] 

CARRIAGE RETURN 

14 

E 

[CTRL N] 

TOGGLE CURSCR 

16 

10 

[CTRL P] 

CLEAR TO END OF SCREEN 

17 

11 

[CTRL Q] 

CLEAR TO END OF LINE 

18 

12 

[CTRL Rj 

CURSCR DCKN 

20 

14 

[CTRL T] 

TOGGLE REVERSE VIDEO 

21 

15 

[CTRL U] 

CURSCR UP 

23 

17 

[CTRL W] 

CURSCR LEFT 

24 

18 

[CTRL X] 

CLEAR TO START OB LINE 

26 

1A 

[CTRL Z] 

CURSCR RIGHT 

27 

IB 

[ESC] 

CURSCR XY POSITION LEAD-IN or 




TCP OF SCREEN LEAD-IN 

There 

are special keys 

on the keyboard 

to generate some of the codes, 


[RETURN], [TAB], [LF] (linefeed), [BACKSPACE], [ESC], [DEL], and cursor arrows. 
A few of the control codes are not too self-explanatory; a [CTRL D] will set the 
reverse video flag to normal in addition to clearing the screen and homing the 
cursor. A [CTRL T] will then toggle the reverse video flag from normal to reverse 
and back without printing on the screen. 


.C U RSO R X -Y P 




[Q 


Many programs utilize* random X-Y positioning of the cursor. This is done by 
outputting a three-byte sequence to the video driver. The first code is an [ESC] 
(1BH) followed by the desired X and Y positions in hex.; The top left corner of 
the screen, is 0, 0. The hex sequence ’IB 40 08’ would cause the cursor to move 
to line 8, character pcsition 64 on the screen. 
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To send the same sequence to the video driver via Microsoft Basic, the following 
statement would be used: 

PRINT CHR$(27);CHR$(X+128);CHR$(Y+128); 

where ’X’ equals 84 (40H) and ’Y’ equals 08 (08H). Adding the value of 128 to X 
and Y in this example sets the eighth bit high. This is done to avoid Microsoft 
Basic from confusing the values as control codes. 

The video driver provides an extensive range of special controls; :however, they 
must be incorporated into the software generating the video stream to be 
meaningful. For instance, a piece of software that merely echoes all characters as 
they go into its input buffer will allow cursor motion on the screen, but this will 
probaly be meaningless to the software. 

SETTING TOP OF SCREEN 

The logical top of screen can be set by sending the appropriate codes (escape 
sequences) to the video driver. To set the top of screen, send the following to the 
video driver: 

IB 7F <line number> 

The line number must be expressed in hex’ in the range of 0H to 16H (0 to 22 
decimal). 
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APPENDIX A - VECTOR 4 CP/M FILE SYSTEM ERRORS 


The BDOS file system has an extensive error handling capability, which, when an 
error is detected, can respond in one of two ways: 

1. It can display an error message on the console and abort the process. 

2. It can return to the calling program with return codes in register 

pair HL identifying the error (as previously described: register A = L 

and register B = H). 

There are two types of errors the file system handles: • ’physical* and ’logical* 
errors. Physical errors pertain directly to hardware limitations and/or malfunctions; 
logical errors pertain to system limitations or illegal usage of a function. 

The SET BDOS ERROR MODE function (function 45) determines how the file system 
handles physical and logical errors. The BDOS Error Mode can exist in two states: 
Default and Return Error modes. In the Default state, the BDOS displays the error 
message on the user's console and terminates the calling process (method 1). In the 
Return Error mode (method 2), the BDOS returns control to the calling process with 
the error identified in registers H and L. The Return mode ensures that CP/M 
does not terminate the process because of a physical or logical error. 

Am. Method 1 

During a BDOS function call, if a physical error is encountered during disk I/O, a 
message is displayed on the console and program execution is terminated and control 
is transferred to the CCP. Physical and logical errors are displayed on the console 
in the following format: 

ERROR - driveKerror> 

where <error> identifies the error. Following is a list of the error messages 
displayed as a result of a physical error: 


DISK READ/WRTTEfexyy) 

The DISK READ/WRITE message will occur when the disk controller 
electronics has detected an error condition in reading or writing to the 
diskette (’xx* is a hex code denoting the particular physical BIOS error 
detected by the physical disk driver; ’yy’ corresponds to the BDOS physical 
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and logical error codes). This condition is generally due to a malfunctioning 
in the disk controller or the result of an extremely worn diskette. If your 
system reports this error more than once a month, it may require servicing or 
your media may need replacement. Recovery from this condition may be 
accomplished by responding to the next prompt: 

PRESS [ CTRL Cl TQ .REBOOT Q R r SETURHLT Q . C ONTINUE 

If a [CTRL C] is entered, the current program will be aborted and control 
returned to the CCP; if a [RETURN] is entered, the error will be ignored by 
the program and execution will continue normally. Pressing [RETURN] would 
only be used when copying a file (using PIP), when it is mandatory that as 
much of the file is recovered as possible. Note, however, that entering a 
[RETURN] may destroy diskette integrity if the operation is a directory write? 
therefore, make sure an adequate backup has been made. 

NOTE: The following BDOS errors will display the particular error message and 

simply wait for user input to reboot; entering any key will cause a warm boot. 

DRIVE SELECT 

The DRIVE SELECT message will occur when there is an attempt to access a 
drive this is not supported by the current hardware/software configuration. In 
this case, the drive which is out of range is displayed along with the error 
message. The system reboots following any input from the terminal. 

DR1YE.JLQT..READ.X 

The DRIVE NOT READY message will occur when an attempt is made to read 
from a drive and the disk is either not properly seated or there is no disk in 
the drive. 

DISK IS WRITE PROTECTED 

The DISK IS WRITE PROTECTED message will occur when there is an attempt 
to write to a disk after the disk has been write-protected by use of a 
write-protect tab on the diskette. 

DISK IS READ-ONLY 

* 

The DISK READ-ONLY message will occur when there is an attempt to write 
to a diskette which has been designated as ’READ/ONLY’ using the STAT 
command, or has been set to ’READ-ONLY* by the BDOS. In general, the 
user should warm boot the system, using [CTRL C], whenever physically 
changing a diskette. If a changed diskette is to be read but not written to, 
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the system allows the diskette to be changed without requiring a warm boot, 
but internally marks the drive as Read-Only. The status of the drive is 
subsequently changed back to ’Read/Write’ following a warm boot. Upon 
displaying the READ-ONLY message, CP/M waits for an input from the 
console; an automatic warm boot will occur following any user input. 

FILE IS READ-ONLY 

The FILE READ-ONLY message will occur when there is an attempt to write 
to a file which has been declared as ’R/O’ using the STAT command or by an 
applications program, or if the file is opened in READ-ONLY mode. The file 
may be returned to READ/WRITE status using the STAT command, if 
necessary. 


Following is a list of the error messages displayed as a result of a logical error: 


FILE.. C UBBE HT L Y . O PEN 

The FILE CURRENTLY OPEN message will occur if an attempt is made to 
access a file which is in use and locked by another user. 

ILLEGAL FIL E ACCESS 

The ILLEGAL FILE ACCESS message will occur when an attempt is made to 
access a file that is not open. 

FILE A LREAD Y E XISTS 

The FILE ALREADY EXISTS message will occur when a user or program is 
trying to create, rename, or spool a specific file which already exists on disk. 

ILLEGAL IN FCB 

The ILLEGAL ’?’ IN FCB message will occur when a question mark is used 
within the FCB in any file function other than SEARCH FIRST (function 17), 
SEARCH NEXT (function 18), and DELETE FILE (function 19). 


FILE OPEN LIST FULL . 


The FILE OPEN LIST FULL message will occur when an attempt is made to 
OPEN (function 15) or CREATE (function 22) a file and the System File List 
is fuli (32 files maximum - list is maintained by the operating system of open 
files in the system, the task(s) which have the files open, and the mode in 
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which the file is open). 

RECOR D L OC K LIS T F ULL 

The RECORD LOCK LIST FULL message will occur when an attempt is made 
to LOCK a record (function 42) and the Record Lock List is full (512 
maximum - series of lists linked to the open file entries of the System File 
List describing which records are locked, and which task has them locked). 
NOTE: records can only be locked in unlocked mode. 

S a Mathod-2 

By using SET BDOS ERROR MODE (function 45), it is possible to inhibit error 
messages and to cause execution to return to the calling program with the physical 
or logical error codes in register H and L. 

The BDOS will return the following logical error codes in register L: 


99 - FUNCTION SUCCESSFUL 

91 - (Read mode): READING UNWRITTEN DATA 

Read past end of file or attempt to access unallocated data block. 

(Write mode): NO DIRECTORY SPACE 
Cannot open new extent. 

92 - NO AVAILABLE DATA BLOCKS (Not returned in random mode) 

Occurs when the write command attempts to allocate a new data block 
to the file and no unallocated data blocks exist on the selected drive. 

(13 - CANNOT CLOSE CURRENT EXTENT 

Occurs when the current extent cannot be closed prior to moving to a 
new extent. 

514 - SEEK TO UNWRITTEN EXTENT 

Attempted to access an extent which has not been created. 

05 - NO AVAILABLE DIRECTORY SPACE (Write mode only) 
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Occurs when the write function attempts to create a new extent that 
requires a new directory entry and no available directory entries exist on 
the selected drive. 

06 - SEES PAST PHYSICAL END OF DISK (random record number out of range) 

Occurs when byte 35 (r2) of the referenced FCB is greater than three. 

07 - RECORD DID NOT MATCH 

Used by TEST AND WRITE RECORD function to indicate non-identical 
records. 

08 - RECORD LOCKED BY ANOTHER TASK 

Occurs when the WRITE FUNCTION attempts to write to a record locked 
by another task. This error is only returned for files open in unlocked 
mode. 

09 - INVALID FCB 

Occurs when the previous BDOS Read or Write call returned an error 
code and invalidated the FCB. 

10 - INVALID FILE ACCESS 

Occurs when an attempt has been made to access a file that has not 
been opened (is not contained within the Open File list). 

11 - UNLOCKED FILE VERIFICATION ERROR 

Occurs if the BDOS cannot locate the FCB's directory entry when 
attempting to verify that the referenced FCB contains current 
information. This error is only returned for files open in unlocked mode. 

12 - NO ROOM IN RECORD LOCK LIST 

Occurs when the sum of the number of records currently locked by the 
calling program and the number of records to be locked by the LOCK 
RECORD call* exceeds the maximum allowed value. 

14 - NO ROOM IN THE OPEN FILE LIST 

Occurs when the Open File list is full. 
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255 - PHYSICAL ERROR (Refer to register H) 

Occurs when a physical error is encountered. For further information 
about the error, check the H register or call function 225, RETURN 
BIOS ERROR CODE; the low-order nybl of the H register will contain 
the physical or logical error code. 


REGISTE R L R ETURN-CODES 

For functions that return error codes, the BDOS sets the high-order nybl to the 
number of sectors successfully read or written before the error is encountered. 
This information is returned only when a process uses the SET MULTI-SECTOR 
COUNT function to set the BDOS logical sector count to a value other than ’1’; 
otherwise, the BDOS sets N1 to zero. Successful read and write functions also set 
the high-order nybl to zero; functions that return a Directory code or an Error 
Flag set it to zero. 

The BDOS returns logical or physical error codes in the low-order nybl only if it is 
in the return error mode; otherwise, it will be set to zero. Following is a list of 
the error codes that are returned in the low-order nybl of register L: 


99 

NO ERROR OR NOT A REGISTER H ERROR 


91 

BAD SECTOR - PERMANENT ERROR 


92 

READ-ONLY DISK 


93 

READ-ONLY FILE 


94 

DRIVE SELECT ERROR 


95 

FILE CURRENTLY OPEN 


96 

CLOSE CHECKSUM ERROR 


98 

FILE ALREADY EXISTS 


99 

ILLEGAL *?* IN FCB 


19 

NO ROOM IN OPEN FILE LIST 


11 

NO ROOM IN RECORD LOCK LIST 


NOTE: 

Register L is equal to zero if the called function i 

s successful. In 


addition, the BDOS sets the low-order nybl of register L to zero when register L 
returns a value other than ’255’. Except for functions that return Directory codes, 
if register L contains a value of ’255’ upon return, the low-order nybl identifies the 
error when the BDOS is in return error mode. 


BDOS DIRECTORY CODES 

99 ” 93 SUCCESSFUL FUNCTION 
255 UNSUCCESSFUL FUNCTION 
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With the exception of the BDOS Search functions, Directory code values 
(0-3) have no significance other than to indicate a successful result. 
However, for the SEARCH functions, a successful Directory code 
identifies the relative starting position of the directory element in the 
calling program’s current DMA buffer. Following is a list of the BDOS 
functions that return a Directory code value: 


Function 15 - OPEN FILE 
Function 16 - CLOSE FILE 
Function 17 - SEARCH FOR FIRST 
Function 18 - SEARCH FOR NEXT 


Function 19 - DELETE FILE 
Function 22 - MAKE FILE 
Function 23 - RENAME FILE 
Function 30 - SET FILE ATTRIBUTES 


NOTEs Because the Directory code values conflict with the BDOS error code 
values, if a value between 1 and 3 is returned it can be assumed that it is a 
Directory code value and not a BDOS error code value. 


There is one last alternate method for handling BDOS error codes that is 
implemented in VECTOR 4 CP/M in order to maintain compatibility with previous 
versions of Vector’s CP/M. This method uses the BDOS functions 225, RETURN 
BIOS ERROR CODE, and 226, INHIBIT/ENABLE BDOS ERRORS; by disabling the 
BDOS error reporting with function 226, the programmer should then call 
function 225 after every access to the BDOS file system for error reporting. 
Function 225 will return either a BIOS disk error code or one of the following: 

80 - BDOS file access error 

81 - BDOS file or record list error 


Rev. A - 9-01-82 


P/N 7100-0003 


A-7 



VECTOR GRAPHIC, INC 


BIOS DISK DRIVER ERRORS - REGISTER H 

HD = Hard Disk 
FD = Floppy Disk 

11 DRIVE NOT READY - HD - Internal mechanical problem. 

12 WRITE PROTECTED - FD - Write-Protect tab is being used; diskette is 

in wrong. 

13 WRITE FAULT - HD - internal but no external write. 

14 TRACK 0 NOT FOUND - HD, FD - Hardware problem. 

21 CONTROLLER BUSY TIMEOUT - HD, FD - Floppy door is open; disk 

drive or controller board problems; fluctuation speed of hard disk. 

22 SEEK COMPLETE TIMEOUT - HD - Not able to step to the next track 
within certain amount of time. 

23 LOSS OF SYNC TIMEOUT - HD - Drive spinning either too fast or too 
slow. 

31 BAD COMMAND CODE - HD, FD - Bad command format. 

32 BAD UNIT VALUE - HD, FD - Bad unit number. 

33 BAD SECTOR VALUE - HD, FD - Bad sector number. 

34 - BAD TRACK VALUE - HD, FD - Bad track number. 

41 TRACKS DON’T MATCH - 41-44 HD - Bad matches. 

42 SECTORS DON’T MATCH 

43 HEADS DON’T MATCH 

44 DATA DOESN’T MATCH 

51-54 must be set using BIOS SOFTERROR routine. 

51 READ CKSUMS DON’T MATCH - FD - Checksum values don't match. 

52 READ/WRITE CKSUMS DON’T MATCH - FD - Checksum values don't 
match. 

53 ECC ERROR - HD, FD - ECC or disk not the same as physical driver 
calculation. 

54 UNCORRECTABLE ECC ERROR - HD, FD - Needs 2 out of 5 retrys to 
correct. 

55 UNCORRECTABLE SPASM ERROR - HD, FD - 

56 SYNC BYTE- ERROR - HD, FD - First byte of each sector is not 'FF» 
and must be. 

E2 DISABLED AND BUSY - Physical driver called for second time and is 

currently busy; results from system crash, FORMAT, or DISKCOPY. 
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APPENDIX B - O CTAVE SETTING S FOR, TONE GENERATORS 


NOTE 

FREQUENCY 

SETTING 

HEX 

ACTUAL FREQUENCY 

C 

65.4 

956 

3BC 

65.4 

c# 

69.3 

902 

386 

69.3 

D 

73.4 

851 

353 

73.4 

D# 

77.8 

804 

324 

77.7 

E 

82.4 

758 

2F6 

82.5 

F 

87.3 

716 

2CC 

87.3 

F# 

92.5 

676 

2A4 

92.5 

G 

98.0 

638 

27E 

98.0 

G# 

103.8 

602 

25A 

103.8 

A 

110.0 

568 

238 

110.0 

A# 

116.5 

536 

218 

116.6 

B 

123.5 

506 

1FA 

123.5 


OCTAVE 2 
C 

130.8 

478 

IDE 

130.8 

C# 

138.6 

451 

1C3 

138.6 

D 

146.8 

426 

1AA 

146.7 

D# 

155.6 

402 

192 

155.5 

E 

164.8 

379 

17B 

164.9 

F 

174.6 

356 

166 

174.6 

F# 

185.0 

338 

152 

184.9 

G 

196.0 

319 

13F 

195.9 

G# 

207.7 

301 

12D 

207.6 

A 

220.0 

284 

11C 

220.1 

A# 

233.1 

268 

10C 

233.2 

B 

246.9 

253 

FD 

247.0 
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OCTAVE 3 


c 

261.6 

239 

EF 

261.5 

c# 

277.2 

225 

El 

277.8 

D 

293.7 

213 

D5 

293.4 

D# 

311.1 

201 

C9 

310.9 

E 

329.6 

190 

BE 

328.9 

F 

349.2 

179 

B3 

349.2 

F# 

370.0 

169 

A9 

369.8 

G 

392.0 

159 

9F 

393.1 

G# 

415.3 

150 

96 

416.7 

A 

440.0 

142 

8E 

440.1 

A# 

466.2 

134 

86 

466.4 

B 

493.9 

127 

7F 

492.1 


OCTAVE 4 

C 

523.3 

119 

77 

525.2 

c# 

554.4 

113 

71 

553.1 

D 

587.3 

106 

6A 

589.6 

D# 

622.3 

100 

64 

625.0 

E 

659.3 

95 

5F 

657.9 

F 

698.5 

89 

59 

702.2 

F# 

740.0 

84 

54 

744.0 

G 

784.0 

80 

50 

781.3 

G# 

830.6 

75 

4B 

833.3 

A 

880.0 

71 

47 

880.3 

A# 

932.3 

67 

43 

932.8 

B 

987.8 

63 

3F 

992.1 


OCTAVE 5 





C 

1046.5 

60 

3C 

1041.7 

c# 

1108.7 

56 

38 

1116.1 

D 

1174.7 

53 

35 

1179.2 

D# 

1244.5 

50 

32 

1250.0 

E 

1318.5 

47 

2F 

1329.3 

F 

1396.9 

45 

2D 

1388.9 
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F# 

1480.0 

42 

2A 

1488.1 

G 

1568.0 

40 

28 

1562.5 

G# 

1661.2 

38 

26 

1844.7 

A 

1660.0 

38 

26 

1644.7 

A# 

1758.7 

36 

24 

1736.1 

B 

1863.3 

34 

22 

1838.2 


OCTAVE 6 


C 

1974.1 

32 

20 

1953.1 

C# 

2091.5 

30 

IE 

2083.3 

D 

2215.8 

28 

1C 

2232.1 

D# 

2347.6 

27 

IB 

2314.8 

E 

2487.2 

25 

19 

2500.0 

F 

2635.1 

24 

18 

2604.2 

F# 

2791.8 

22 

16 

2840.9 

G 

2957.8 

21 

15 

2976.2 

G# 

3133.7 

20 

14 

3125.0 

A 

3320.0 

19 

13 

3289.5 

A# 

3517.4 

18 

12 

3472.2 

B 

3726.6 

17 

11 

3676.5 


OCTAVE 7 


C 

3948.2 

16 

10 

3906.3 

C# 

4182.9 

15 

F 

4166.7 

D 

4431.7 

14 

E 

4464.3 

D# 

4695.2 

13 

D 

4807.7 

E 

4974.4 

13 

D 

4807.7 

F 

5270.2 

12 

C 

5208.3 

F# 

5583.6 

11 

B 

5681.8 

G 

5915.6 

11 

B 

5681.8 

G# 

6267.3 

10 

A 

6250.0 
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